Edit

Share via

HttpRequest Class

Main object for structuring a request.

Properties

body

body: string;

Content of the body of the HTTP request.

Type: string

Notes:

  • This property can be edited in early-execution mode.

headers

headers: HttpHeader[];

A collection of HTTP headers to add to the outbound request.

Type: HttpHeader[]

Notes:

  • This property can be edited in early-execution mode.

method

method: HttpRequestMethod;

HTTP method (e.g., GET or PUT or PATCH) to use for making the request.

Type: HttpRequestMethod

Notes:

  • This property can be edited in early-execution mode.

timeout

timeout: number;

Amount of time, in seconds, before the request times out and is abandoned.

Type: number

Notes:

  • This property can be edited in early-execution mode.

uri

uri: string;

The HTTP resource to access.

Type: string

Notes:

  • This property can be edited in early-execution mode.

Methods

constructor

new HttpRequest(uri: string)

Parameters

  • uri: string

Returns HttpRequest

addHeader

addHeader(key: string, value: minecraftserveradmin.SecretString | string): HttpRequest

Adds an additional header to the overall list of headers used in the corresponding HTTP request.

Parameters

Returns HttpRequest

Notes:

  • This function can be called in early-execution mode.

setBody

setBody(body: string): HttpRequest

Updates the content of the body of the HTTP request.

Parameters

  • body: string

Returns HttpRequest

Notes:

  • This function can be called in early-execution mode.

setHeaders

setHeaders(headers: HttpHeader[]): HttpRequest

Replaces and applies a set of HTTP Headers for the request.

Parameters

Returns HttpRequest

Notes:

  • This function can be called in early-execution mode.

setMethod

setMethod(method: HttpRequestMethod): HttpRequest

Sets the desired HTTP method (e.g., GET or PUT or PATCH) to use for making the request.

Parameters

Returns HttpRequest

Notes:

  • This function can be called in early-execution mode.

setTimeout

setTimeout(timeout: number): HttpRequest

Parameters

  • timeout: number

Returns HttpRequest

Notes:

  • This function can be called in early-execution mode.

Examples

simpleHttpRequest.ts
import { HttpRequest, HttpHeader, HttpRequestMethod, http } from '@minecraft/server-net';

async function updateScore() {
    const req = new HttpRequest('http://localhost:3000/updateScore');

    req.body = JSON.stringify({
        score: 22,
    });

    req.method = HttpRequestMethod.Post;
    req.headers = [
        new HttpHeader('Content-Type', 'application/json'),
        new HttpHeader('auth', 'my-auth-token'),
    ];

    await http.request(req);
}

(preview) Work with this sample on the MCTools.dev code sandbox.