Clipboard: phương thức readText()

Baseline 2024

Newly available

Since April 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

Phương thức readText() của giao diện Clipboard trả về một Promise phân giải với bản sao nội dung văn bản của clipboard hệ thống.

Note: Để đọc nội dung không phải văn bản từ clipboard, hãy sử dụng phương thức read() thay thế. Bạn có thể ghi văn bản vào clipboard bằng writeText().

Cú pháp

readText()

NotAllowedError DOMException: Ném ra nếu việc truy cập để đọc clipboard không được cho phép.
NotFoundError DOMException: Ném ra khi clipboard cho biết nó chứa dữ liệu có thể được biểu diễn dưới dạng văn bản nhưng không thể cung cấp biểu diễn văn bản.

Consideration về bảo mật

Việc đọc từ clipboard chỉ có thể được thực hiện trong secure context.

Các yêu cầu bảo mật bổ sung được đề cập trong phần Consideration về bảo mật của chủ đề tổng quan API.

Ví dụ

Ví dụ này truy xuất nội dung văn bản của clipboard và chèn văn bản trả về vào nội dung của phần tử đã chọn.

const destination = document.getElementById("outbox");
destinationImage.addEventListener("click", () => {
  navigator.clipboard
    .readText()
    .then((clipText) => (destination.innerText = clipText));
});