chrome.idle

refresh date: 2026-09-25 robots: noindex

คำอธิบาย

ใช้ chrome.idle API เพื่อตรวจหาเมื่อสถานะไม่มีการใช้งานของเครื่องมีการเปลี่ยนแปลง

สิทธิ์

idle

ไฟล์ Manifest

คุณต้องประกาศสิทธิ์ "ไม่ได้ใช้งาน" ในไฟล์ Manifest ของส่วนขยายเพื่อใช้ Idle API เช่น

{
  "name": "My extension",
  ...
  "permissions": [
    "idle"
  ],
  ...
}

ประเภท

IdleState

Chrome 44 ขึ้นไป

ค่าแจกแจง

"ใช้งานอยู่"

"ไม่มีการใช้งาน"

"ล็อก"

เมธอด

getAutoLockDelay()

Promise Chrome 73 ขึ้นไป ChromeOS เท่านั้น 
chrome.idle.getAutoLockDelay(
  callback?: function,
): Promise<number>

รับเวลาเป็นวินาทีจนกว่าหน้าจอจะล็อกโดยอัตโนมัติขณะไม่มีการใช้งาน แสดงระยะเวลาเป็น 0 หากไม่มีการล็อกหน้าจอโดยอัตโนมัติ ปัจจุบันรองรับเฉพาะใน ChromeOS

พารามิเตอร์

  • callback

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

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

    (delay: number) => void

    • ล่าช้า

      ตัวเลข

      เวลาเป็นวินาทีจนกว่าหน้าจอจะล็อกโดยอัตโนมัติขณะไม่มีการใช้งาน ค่านี้จะเป็น 0 หากหน้าจอไม่เคยล็อกโดยอัตโนมัติ

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

  • Promise<หมายเลข>

    Chrome 116 ขึ้นไป

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

queryState()

Promise 
chrome.idle.queryState(
  detectionIntervalInSeconds: number,
  callback?: function,
): Promise<IdleState>

แสดงผล "locked" หากระบบล็อกอยู่ "idle" หากผู้ใช้ไม่ได้สร้างอินพุตใดๆ เป็นเวลาตามจำนวนวินาทีที่ระบุ หรือ "active" ในกรณีอื่นๆ

พารามิเตอร์

  • detectionIntervalInSeconds

    ตัวเลข

    ระบบจะถือว่าไม่มีการใช้งานหากผ่านไปแล้ว detectionIntervalInSeconds วินาทีนับตั้งแต่ตรวจพบข้อมูลจากผู้ใช้ครั้งล่าสุด

  • callback

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

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

    (newState: IdleState) => void

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

  • Promise<IdleState>

    Chrome 116 ขึ้นไป

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

setDetectionInterval()

chrome.idle.setDetectionInterval(
  intervalInSeconds: number,
): void

กำหนดช่วงเวลาเป็นวินาทีที่ใช้ในการพิจารณาว่าเมื่อใดที่ระบบอยู่ในสถานะไม่มีการใช้งานสำหรับเหตุการณ์ onStateChanged ช่วงเวลาเริ่มต้นคือ 60 วินาที

พารามิเตอร์

  • intervalInSeconds

    ตัวเลข

    เกณฑ์เป็นวินาทีที่ใช้ในการพิจารณาว่าระบบอยู่ในสถานะว่างเมื่อใด

กิจกรรม

onStateChanged

chrome.idle.onStateChanged.addListener(
  callback: function,
)

ทริกเกอร์เมื่อระบบเปลี่ยนเป็นสถานะใช้งานอยู่ ว่าง หรือล็อก เหตุการณ์จะทริกเกอร์ด้วย "locked" หากหน้าจอล็อกหรือโปรแกรมรักษาหน้าจอเปิดใช้งาน "idle" หากระบบปลดล็อกและผู้ใช้ไม่ได้สร้างอินพุตใดๆ เป็นเวลาตามจำนวนวินาทีที่ระบุ และ "active" เมื่อผู้ใช้สร้างอินพุตในระบบที่ไม่ได้ใช้งาน

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (newState: IdleState) => void