chrome.clipboard

คำอธิบาย

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

สิทธิ์

clipboard

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

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

ประเภท

AdditionalDataItem

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

  • ข้อมูล

    string

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

  • ประเภท

    DataItemType

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

DataItemType

ค่าแจกแจง

"textPlain"

"textHtml"

ImageType

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

ค่าแจกแจง

"png"

"jpeg"

วิธีการ

setImageData()

คำมั่นสัญญา Chrome เวอร์ชัน 57 ขึ้นไป 
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
)

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

พารามิเตอร์

  • imageData

    ArrayBuffer

    Chrome 60 ขึ้นไป

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

  • ประเภท

    ImageType

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

  • additionalItems

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

    Chrome 60 ขึ้นไป

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

  • Callback

    ฟังก์ชัน ไม่บังคับ

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

    ()=>void

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

  • Promise<void>

    Chrome 91 ขึ้นไป

    Promiss รองรับเฉพาะไฟล์ Manifest V3 ขึ้นไป ส่วนแพลตฟอร์มอื่นๆ จะต้องใช้โค้ดเรียกกลับ

กิจกรรม

onClipboardDataChanged

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

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

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

    ()=>void