chrome.clipboard

คำอธิบาย

API chrome.clipboard มีไว้เพื่อให้ผู้ใช้เข้าถึงข้อมูลของคลิปบอร์ดได้ นี่เป็นวิธีแก้ปัญหาชั่วคราวสำหรับแอปแพลตฟอร์ม ChromeOS จนกว่าจะมีทางเลือกอื่นในเว็บแบบเปิด เราจะเลิกใช้งานเมื่อโซลูชัน Open Web พร้อมใช้งาน ซึ่งอาจเป็นไตรมาสที่ 4 ของปี 2017

สิทธิ์

clipboard

ความพร้อมใช้งาน

เวอร์ชันที่กำลังพัฒนา ChromeOS เท่านั้น

ประเภท

AdditionalDataItem

พร็อพเพอร์ตี้

  • เพิ่มเติม

    สตริง

    เนื้อหาของรายการข้อมูลเพิ่มเติม สตริงข้อความธรรมดาหาก type เป็น "textPlain" หรือสตริงมาร์กอัปหาก type เป็น "textHtml" ข้อมูลต้องมีขนาดไม่เกิน 2 MB

  • ประเภท

    DataItemType

    ประเภทของรายการข้อมูลเพิ่มเติม

DataItemType

ค่าแจกแจง

"textPlain"

"textHtml"

ImageType

ประเภทรูปภาพที่รองรับ

ค่าแจกแจง

"png"

"jpeg"

เมธอด

setImageData()

Promise Chrome 57 ขึ้นไป 
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
): Promise<void>

ตั้งค่าข้อมูลรูปภาพไปยังคลิปบอร์ด

พารามิเตอร์

  • imageData

    ArrayBuffer

    Chrome 60 ขึ้นไป

    ข้อมูลรูปภาพที่เข้ารหัส

  • ประเภท

    ImageType

    ประเภทของรูปภาพที่ส่ง

  • additionalItems

    AdditionalDataItem[] ไม่บังคับ

    Chrome 60 ขึ้นไป

    รายการข้อมูลเพิ่มเติมสำหรับอธิบายข้อมูลรูปภาพ ระบบจะเรียกใช้ Callback โดยตั้งค่า chrome.runtime.lastError เป็นรหัสข้อผิดพลาดหากมีข้อผิดพลาด ต้องมีสิทธิ์ clipboard และ clipboardWrite

  • callback

    function ไม่บังคับ

    พารามิเตอร์ callback จะมีลักษณะดังนี้ 

    () => void

การคืนสินค้า

  • Promise<void>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

กิจกรรม

onClipboardDataChanged

Chrome 56 ขึ้นไป 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

เริ่มทำงานเมื่อข้อมูลคลิปบอร์ดมีการเปลี่ยนแปลง ต้องมีสิทธิ์ clipboard และ clipboardRead เพื่อเพิ่ม Listener ไปยังเหตุการณ์ chrome.clipboard.onClipboardDataChanged หลังจากเหตุการณ์นี้เริ่มทำงาน ข้อมูลคลิปบอร์ดจะพร้อมใช้งานโดยการเรียกใช้ document.execCommand('paste')

พารามิเตอร์

  • callback

    ฟังก์ชัน

    พารามิเตอร์ callback จะมีลักษณะดังนี้ 

    () => void