chrome.clipboard

คำอธิบาย

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

สิทธิ์

clipboard

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

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

ประเภท

AdditionalDataItem

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

  • ข้อมูล

    สตริง

    เนื้อหาของรายการข้อมูลเพิ่มเติม สตริงข้อความธรรมดาหาก 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,
)

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

พารามิเตอร์

  • ข้อมูลรูปภาพ

    อาร์เรย์บัฟเฟอร์

    Chrome 60 ขึ้นไป

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

  • ประเภท

    ImageType

    ประเภทของรูปภาพที่กำลังส่งผ่าน

  • additionalItems

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

    Chrome 60 ขึ้นไป

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

  • Callback

    ไม่บังคับ

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

    () => void

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

  • คำมั่นสัญญา<โมฆะ>

    Chrome 91 ขึ้นไป

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

กิจกรรม

onClipboardDataChanged

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

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

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

    () => void