Request

Constructor

Request()

Tạo một đối tượng Request mới.

Thuộc tính thể hiện

Request.body Read only

Một ReadableStream chứa nội dung body.

Request.bodyUsed Read only

Trả về true hoặc false để cho biết body đã được dùng trong request hay chưa.

Request.cache Read only

Chứa chế độ cache của request, ví dụ default, reload, no-cache.

Request.credentials Read only

Chứa giá trị điều khiển việc có bao gồm thông tin xác thực trong request hay không, ví dụ omit, same-origin, include. Mặc định là same-origin.

Request.destination Read only

Chuỗi mô tả loại nội dung đang được yêu cầu.

Request.duplex Read only Experimental

Chế độ duplex của request, xác định việc trình duyệt có phải gửi toàn bộ request trước khi xử lý response hay không.

Request.headers Read only

Chứa đối tượng Headers liên kết với request.

Request.integrity Read only

Chứa giá trị subresource integrity của request, ví dụ sha256-BpfBw7ivV8q2jLiT13fxDYAe2tJllusRSZ273h2nFSE=.

Request.isHistoryNavigation Read only

Một giá trị boolean cho biết request có phải là điều hướng lịch sử hay không.

Request.keepalive Read only

Chứa thiết lập keepalive của request (true hoặc false), cho biết trình duyệt có tiếp tục giữ request này hoạt động nếu trang khởi tạo nó bị tải dỡ trước khi request hoàn tất hay không.

Request.method Read only

Chứa phương thức của request (GET, POST, v.v.).

Request.mode Read only

Chứa chế độ của request, ví dụ cors, no-cors, same-origin, navigate.

Request.redirect Read only

Chứa chế độ xử lý chuyển hướng. Giá trị có thể là follow, error hoặc manual.

Request.referrer Read only

Chứa referrer của request, ví dụ client.

Request.referrerPolicy Read only

Chứa chính sách referrer của request, ví dụ no-referrer.

Request.signal Read only

Trả về AbortSignal liên kết với request.

Request.url Read only

Chứa URL của request.

Phương thức thể hiện

Request.arrayBuffer()

Trả về một promise giải quyết với biểu diễn ArrayBuffer của body request.

Request.blob()

Trả về một promise giải quyết với biểu diễn Blob của body request.

Request.bytes()

Trả về một promise giải quyết với biểu diễn Uint8Array của body request.

Request.clone()

Tạo một bản sao của đối tượng Request hiện tại.

Request.formData()

Trả về một promise giải quyết với biểu diễn FormData của body request.

Request.json()

Trả về một promise giải quyết với kết quả phân tích body request dưới dạng JSON.

Request.text()

Trả về một promise giải quyết với biểu diễn văn bản của body request.

Ví dụ

Trong đoạn mã sau, chúng ta tạo một request mới bằng hàm khởi tạo Request() rồi lấy một vài giá trị thuộc tính của request:

const request = new Request("https://www.mozilla.org/favicon.ico");

const url = request.url;
const method = request.method;
const credentials = request.credentials;

Sau đó bạn có thể fetch request này bằng cách truyền đối tượng Request vào lời gọi fetch(), ví dụ:

fetch(request)
  .then((response) => response.blob())
  .then((blob) => {
    image.src = URL.createObjectURL(blob);
  });

Trong đoạn mã sau, chúng ta tạo một request mới bằng hàm khởi tạo Request() với một số dữ liệu khởi tạo và nội dung body cho một request API cần payload:

const request = new Request("https://example.com", {
  method: "POST",
  body: '{"foo": "bar"}',
});

const url = request.url;
const method = request.method;
const credentials = request.credentials;
const bodyUsed = request.bodyUsed;

Sau đó bạn có thể fetch request API này bằng cách truyền đối tượng Request vào lời gọi fetch() và nhận response:

fetch(request)
  .then((response) => {
    if (response.status !== 200) {
      throw new Error("Something went wrong on API server!");
    }
    return response.json();
  })
  .then((response) => {
    console.debug(response);
    // …
  })
  .catch((error) => {
    console.error(error);
  });

Thông số kỹ thuật

Tương thích trình duyệt

Xem thêm

• ServiceWorker API
• HTTP access control (CORS)
• HTTP