XMLHttpRequest: thuộc tính responseType

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since November 2016.

Note: This feature is available in Web Workers, except for Service Workers.

Thuộc tính XMLHttpRequest responseType là một giá trị chuỗi được liệt kê chỉ định loại dữ liệu chứa trong phản hồi.

Nó cũng cho phép tác giả thay đổi loại phản hồi. Nếu một chuỗi rỗng được đặt làm giá trị của responseType, giá trị mặc định text sẽ được sử dụng.

Giá trị

Một chuỗi chỉ định loại dữ liệu mà phản hồi chứa. Nó có thể nhận các giá trị sau:

""

Một chuỗi responseType rỗng giống như "text", loại mặc định.

"arraybuffer"

response là một ArrayBuffer JavaScript chứa dữ liệu nhị phân.

"blob"

response là một đối tượng Blob chứa dữ liệu nhị phân.

"document"

response là một Document HTML hoặc XMLDocument XML, tùy thuộc vào kiểu MIME của dữ liệu nhận được. Xem HTML trong XMLHttpRequest để tìm hiểu thêm về việc sử dụng XHR để lấy nội dung HTML.

"json"

response là một đối tượng JavaScript được tạo bằng cách phân tích cú pháp nội dung dữ liệu nhận được dưới dạng JSON.

"text"

response là một văn bản trong chuỗi.

Note: Khi đặt responseType thành một giá trị cụ thể, tác giả nên đảm bảo rằng máy chủ thực sự đang gửi một phản hồi tương thích với định dạng đó. Nếu máy chủ trả về dữ liệu không tương thích với responseType đã đặt, giá trị của response sẽ là null.

Ngoại lệ

InvalidAccessError DOMException

Một nỗ lực thay đổi giá trị của responseType trên một XMLHttpRequest đang ở chế độ đồng bộ nhưng không nằm trong Worker. Để biết thêm chi tiết, xem Các hạn chế XHR đồng bộ bên dưới.

Ghi chú sử dụng

Các hạn chế XHR đồng bộ

Bạn không thể thay đổi giá trị của responseType trong một XMLHttpRequest đồng bộ trừ khi yêu cầu thuộc về một Worker. Hạn chế này được thiết kế một phần để giúp đảm bảo rằng các hoạt động đồng bộ không được sử dụng cho các giao dịch lớn chặn luồng chính của trình duyệt, do đó làm chậm trải nghiệm người dùng.

Các yêu cầu XHR không đồng bộ theo mặc định; chúng chỉ được đặt ở chế độ đồng bộ bằng cách truyền false làm giá trị của tham số async tùy chọn khi gọi open().

Các hạn chế trong Workers

Các nỗ lực đặt giá trị của responseType thành document bị bỏ qua trong một Worker.

Các đặc tả kỹ thuật

Specification
XMLHttpRequest
# the-responsetype-attribute

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

Xem thêm