Sanitizer: phương thức get()

Khả dụng hạn chế

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Phương thức get() của giao diện Sanitizer trả về một phiên bản từ điển SanitizerConfig đại diện cho cấu hình Sanitizer hiện tại.

Điều này có thể được dùng để tạo một bộ làm sạch được sửa đổi nhẹ so với mặc định; bằng cách trước tiên lấy rồi sửa đổi cấu hình Sanitizer mặc định, và sau đó dùng nó để xây dựng một Sanitizer mới.

Cấu hình được trả về cũng có thể được dùng để kiểm tra cấu hình, và có thể được truyền trực tiếp cho các hàm phân tích HTML. Tuy nhiên, lưu ý rằng sẽ hiệu quả hơn khi truyền Sanitizer thay vì từ điển cấu hình, đặc biệt là khi Sanitizer được dùng nhiều lần.

Cú pháp

js
get()

Tham số

Không có

Giá trị trả về

Một SanitizerConfig.

Ví dụ

Lấy cấu hình

Ví dụ này cho thấy cách bạn có thể tạo một bộ làm sạch mới và lấy cấu hình của nó.

JavaScript

Mã sau kiểm tra xem giao diện Sanitizer có được hỗ trợ không, và nếu có thì tạo một đối tượng Sanitizer mới bằng cách dùng SanitizerConfig đơn giản cho phép các phần tử HTML: <div>, <p>, <span>, <script>. Sau đó nó lấy và ghi nhật ký cấu hình.

js
// Tạo bộ làm sạch sử dụng SanitizerConfig
const sanitizer = new Sanitizer({ elements: ["div", "p", "span", "script"] });

// Lấy cấu hình hiện tại
const sanitizerConfig = sanitizer.get();

log(JSON.stringify(sanitizerConfig, null, 2));

Kết quả

Đầu ra được ghi nhật ký bên dưới. Lưu ý rằng cùng các phần tử được đặt khi xây dựng bộ làm sạch được trả về, nhưng các phần tử mới cũng có không gian tên. Lưu ý rằng các chú thích và thuộc tính dữ liệu sẽ được phép.

Lấy bộ làm sạch mặc định

Ví dụ này cho thấy cách bạn có thể lấy cấu hình cho Sanitizer mặc định. Sau đó có thể sửa đổi và dùng để tạo Sanitizer mới đáp ứng nhu cầu cụ thể của bạn.

JavaScript

Mã sau kiểm tra xem giao diện Sanitizer có được hỗ trợ không. Sau đó tạo Sanitizer mặc định, không truyền tùy chọn, rồi lấy và ghi nhật ký cấu hình.

js
// Tạo bộ làm sạch mặc định
const sanitizer = new Sanitizer();

// Lấy cấu hình mặc định
const defaultConfig = sanitizer.get();

log(JSON.stringify(defaultConfig, null, 2));

Kết quả

Cấu hình bộ làm sạch mặc định được ghi nhật ký bên dưới. Lưu ý rằng cấu hình mặc định khá lớn, cho phép nhiều phần tử và thuộc tính.

Thông số kỹ thuật

Thông số kỹ thuật
HTML Sanitizer API
# dom-sanitizer-get

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