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
responseTyperỗng giống như"text", loại mặc định. "arraybuffer"-
responselà mộtArrayBufferJavaScript chứa dữ liệu nhị phân. "blob"-
responselà một đối tượngBlobchứa dữ liệu nhị phân. "document"-
responselà mộtDocumentHTML hoặcXMLDocumentXML, 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"-
responselà 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"-
responselà 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ệ
InvalidAccessErrorDOMException-
Một nỗ lực thay đổi giá trị của
responseTypetrên mộtXMLHttpRequestđang ở chế độ đồng bộ nhưng không nằm trongWorker. Để 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
- Sử dụng XMLHttpRequest
- HTML trong XMLHttpRequest
- Dữ liệu phản hồi:
response,responseText, vàresponseXML