Clipboard: phương thức writeText()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2020.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Phương thức writeText() của giao diện Clipboard ghi văn bản đã chỉ định vào clipboard hệ thống, trả về một Promise được phân giải khi clipboard hệ thống được cập nhật.
Cú pháp
writeText(newClipText)
Tham số
newClipText-
Chuỗi sẽ được ghi vào clipboard.
Giá trị trả về
Một Promise được phân giải khi nội dung của clipboard đã được cập nhật.
Ngoại lệ
NotAllowedErrorDOMException-
Ném ra nếu việc ghi vào clipboard không được cho phép.
Consideration về bảo mật
Việc ghi vào 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 đặt nội dung của clipboard thành chuỗi "<empty clipboard>".
button.addEventListener("click", () => writeClipboardText("<empty clipboard>"));
async function writeClipboardText(text) {
try {
await navigator.clipboard.writeText(text);
} catch (error) {
console.error(error.message);
}
}
Các đặc tả kỹ thuật
| Specification |
|---|
| Clipboard API and events # dom-clipboard-writetext |