Clipboard
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.
* Some parts of this feature may have varying levels of support.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Giao diện Clipboard của API Clipboard cung cấp khả năng đọc và ghi vào nội dung của clipboard hệ thống.
Điều này cho phép ứng dụng web triển khai các tính năng cắt, sao chép và dán.
Clipboard hệ thống được truy cập thông qua thuộc tính toàn cục Navigator.clipboard.
Tất cả các phương thức của Clipboard API hoạt động bất đồng bộ; chúng trả về một Promise sẽ được phân giải khi việc truy cập clipboard hoàn tất.
Promise sẽ bị từ chối nếu việc truy cập clipboard bị từ chối.
Tất cả các phương thức đều yêu cầu secure context. Các yêu cầu bổ sung để sử dụng API được thảo luận trong phần Consideration về bảo mật của chủ đề tổng quan API.
Phương thức instance
Clipboard dựa trên giao diện EventTarget, và bao gồm các phương thức của nó.
read()-
Yêu cầu dữ liệu tùy ý (chẳng hạn như hình ảnh) từ clipboard, trả về một
Promisephân giải với mảng các đối tượngClipboardItemchứa nội dung của clipboard. readText()-
Yêu cầu văn bản từ clipboard hệ thống, trả về một
Promiseđược phân giải với chuỗi chứa văn bản của clipboard khi nó sẵn sàng. write()-
Ghi dữ liệu tùy ý vào clipboard hệ thống, trả về một
Promisephân giải khi thao tác hoàn tất. writeText()-
Ghi văn bản vào clipboard hệ thống, trả về một
Promiseđược phân giải khi văn bản đã được sao chép hoàn toàn vào clipboard.
Sự kiện
clipboardchangeExperimental-
Được kích hoạt khi nội dung clipboard hệ thống thay đổi theo bất kỳ cách nào, ví dụ qua lệnh sao chép của hệ thống, hoặc qua phương thức API như
Clipboard.writeText().
Các đặc tả kỹ thuật
| Specification |
|---|
| Clipboard API and events # clipboard-interface |