Struct Response

pub struct Response { /* private fields */ }

A response from a fetch request

Implementations

impl Response

pub fn status(&self) -> u16

Get the status code

pub fn ok(&self) -> bool

Check if the response was successful (status 200-299)

pub fn header(&self, name: &str) -> Result<Option<String>>

Get a header value

pub async fn text(&self) -> Result<String>

Get the response body as text

pub async fn json<T: for<'de> Deserialize<'de>>(&self) -> Result<T>

Get the response body as JSON

Examples found in repository

examples/github_api.rs (line 25)

async fn get_github_branch(repo: String) -> Result<GitHubBranch> {
    let url = format!("https://api.github.com/repos/{}/branches/master", repo);

    let response = get(&url).await?.error_for_status()?;

    response.json().await
}

/// Advanced GET request with custom headers
async fn get_github_branch_advanced(repo: String) -> Result<GitHubBranch> {
    let client = Client;
    let url = format!("https://api.github.com/repos/{}/branches/master", repo);

    let response = client
        .get(url)
        .header("Accept", "application/vnd.github.v3+json")
        .header("User-Agent", "rust-wasm-fetch")
        .send()
        .await?
        .error_for_status()?;

    response.json().await
}

pub async fn json_value(&self) -> Result<Value>

Get the response body as a dynamic JSON value

Examples found in repository

examples/github_api.rs (line 66)

async fn create_github_issue(repo: String, title: String, body: String) -> Result<Value> {
    let client = Client;
    let url = format!("https://api.github.com/repos/{}/issues", repo);

    let issue = CreateIssue { title, body };

    let response = client
        .post(url)
        .header("Accept", "application/vnd.github.v3+json")
        .header("Authorization", "token YOUR_GITHUB_TOKEN")
        .json(&issue)?
        .send()
        .await?
        .error_for_status()?;

    response.json_value().await
}

pub async fn bytes(&self) -> Result<Vec<u8>>

Get the response body as bytes

pub fn error_for_status(self) -> Result<Self>

Ensure the response was successful, returning an error if not

Examples found in repository

examples/github_api.rs (line 23)

async fn get_github_branch(repo: String) -> Result<GitHubBranch> {
    let url = format!("https://api.github.com/repos/{}/branches/master", repo);

    let response = get(&url).await?.error_for_status()?;

    response.json().await
}

/// Advanced GET request with custom headers
async fn get_github_branch_advanced(repo: String) -> Result<GitHubBranch> {
    let client = Client;
    let url = format!("https://api.github.com/repos/{}/branches/master", repo);

    let response = client
        .get(url)
        .header("Accept", "application/vnd.github.v3+json")
        .header("User-Agent", "rust-wasm-fetch")
        .send()
        .await?
        .error_for_status()?;

    response.json().await
}

#[derive(Serialize)]
struct CreateIssue {
    title: String,
    body: String,
}

/// POST request with JSON body
async fn create_github_issue(repo: String, title: String, body: String) -> Result<Value> {
    let client = Client;
    let url = format!("https://api.github.com/repos/{}/issues", repo);

    let issue = CreateIssue { title, body };

    let response = client
        .post(url)
        .header("Accept", "application/vnd.github.v3+json")
        .header("Authorization", "token YOUR_GITHUB_TOKEN")
        .json(&issue)?
        .send()
        .await?
        .error_for_status()?;

    response.json_value().await
}