TextDecoder: TextDecoder() constructor

Baseline Widely available

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

Note: This feature is available in Web Workers.

Hàm tạo TextDecoder() trả về một đối tượng TextDecoder mới.

Cú pháp

js
new TextDecoder()
new TextDecoder(label)
new TextDecoder(label, options)

Tham số

label Optional

Một chuỗi xác định mã hóa ký tự mà bộ giải mã này sẽ sử dụng. Có thể là bất kỳ nhãn hợp lệ nào.

Mặc định là "utf-8".

options Optional

Một đối tượng với các thuộc tính sau:

fatal Optional

Một giá trị boolean cho biết phương thức TextDecoder.decode() có phải ném ra TypeError khi giải mã dữ liệu không hợp lệ hay không. Mặc định là false, nghĩa là bộ giải mã sẽ thay dữ liệu lỗi bằng ký tự thay thế.

ignoreBOM Optional

Một giá trị boolean cho biết byte order mark sẽ được đưa vào đầu ra hay bị bỏ qua. Mặc định là false, nghĩa là byte order mark sẽ bị bỏ qua khi giải mã và không được đưa vào văn bản đã giải mã.

Ngoại lệ

RangeError

Được ném ra nếu giá trị của label không xác định, hoặc là một trong các giá trị dẫn đến thuật toán giải mã 'replacement' ("iso-2022-cn" hoặc "iso-2022-cn-ext").

Ví dụ

js
const textDecoder1 = new TextDecoder("iso-8859-2");

const textDecoder2 = new TextDecoder();

const textDecoder3 = new TextDecoder("csiso2022kr", { fatal: true });
// Allows TypeError exception to be thrown.

const textDecoder4 = new TextDecoder("iso-2022-cn");
// Throws a RangeError exception.

Thông số kỹ thuật

Thông số kỹ thuật
Encoding
# ref-for-dom-textdecoder①

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

Xem thêm