Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

GET Request

Performs a GET request to the specified URL with automatic error handling.

Parameters

  • url (URL): The URL to send the GET request to (typically created with createUrl)

Returns

A Promise that resolves to the Response object if successful.

Throws

Will throw an error if the response status is not ok (status >= 400).

Examples

Basic GET Request

const url = Deno.api.host.createUrl("vrm/all");
const response = await Deno.api.host.get(url);
const vrms = await response.json();

console.log('Available VRMs:', vrms);

GET with Query Parameters

const url = Deno.api.host.createUrl("entities", {
    name: "MyCharacter"
});
const response = await Deno.api.host.get(url);
const entities = await response.json();

Error Handling

try {
    const url = Deno.api.host.createUrl("vrm/999"); // Non-existent VRM
    const response = await Deno.api.host.get(url);
    const data = await response.json();
} catch (error) {
    console.error('GET request failed:', error.message);
    // Error message includes URL, status, and response text
}
  • createUrl - Creates URLs for GET requests
  • post - POST requests with request body
  • put - PUT requests for updates