chrome.processes

คำอธิบาย

ใช้ chrome.processes API เพื่อโต้ตอบกับกระบวนการของเบราว์เซอร์

สิทธิ์

processes

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

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

ประเภท

Cache

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

  • liveSize

    ตัวเลข

    ส่วนของแคชที่ใช้ในหน่วยไบต์

  • ขนาด

    ตัวเลข

    ขนาดของแคชในหน่วยไบต์

Process

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

  • cpu

    หมายเลข ไม่บังคับ

    การวัดการใช้งาน CPU ของกระบวนการล่าสุด ซึ่งแสดงเป็นเปอร์เซ็นต์ของ CPU 1 แกนโดยรวมที่ใช้โดยเทรดทั้งหมดของกระบวนการ ซึ่งจะให้ค่าตั้งแต่ 0 ถึง CpuInfo.numOfProcessors*100 ซึ่งอาจเกิน 100% ในกระบวนการแบบหลายชุดข้อความ ใช้ได้เฉพาะเมื่อได้รับออบเจ็กต์ที่เป็นส่วนหนึ่งของ Callback จาก onUpdated หรือ onUpdatedWithMemory เท่านั้น

  • cssCache

    แคช ไม่บังคับ

    ข้อมูลล่าสุดเกี่ยวกับแคช CSS สำหรับกระบวนการ ใช้ได้เฉพาะเมื่อได้รับออบเจ็กต์ที่เป็นส่วนหนึ่งของ Callback จาก onUpdated หรือ onUpdatedWithMemory เท่านั้น

  • id

    ตัวเลข

    รหัสที่ไม่ซ้ำกันของกระบวนการที่เบราว์เซอร์ระบุ

  • imageCache

    แคช ไม่บังคับ

    ข้อมูลล่าสุดเกี่ยวกับแคชรูปภาพสำหรับกระบวนการ ใช้ได้เฉพาะเมื่อได้รับออบเจ็กต์ที่เป็นส่วนหนึ่งของ Callback จาก onUpdated หรือ onUpdatedWithMemory เท่านั้น

  • jsMemoryAllocated

    หมายเลข ไม่บังคับ

    การวัดล่าสุดของกระบวนการที่ JavaScript จัดสรรหน่วยความจำในหน่วยไบต์ ใช้ได้เฉพาะเมื่อได้รับออบเจ็กต์ที่เป็นส่วนหนึ่งของ Callback จาก onUpdated หรือ onUpdatedWithMemory เท่านั้น

  • jsMemoryUsed

    หมายเลข ไม่บังคับ

    การวัดล่าสุดของกระบวนการหน่วยความจำ JavaScript ที่ใช้ในหน่วยไบต์ ใช้ได้เฉพาะเมื่อได้รับออบเจ็กต์ที่เป็นส่วนหนึ่งของ Callback จาก onUpdated หรือ onUpdatedWithMemory เท่านั้น

  • naclDebugPort

    ตัวเลข

    พอร์ตการแก้ไขข้อบกพร่องสำหรับกระบวนการ Native Client 0 สำหรับกระบวนการประเภทอื่นๆ และสำหรับกระบวนการ NaCl ที่ไม่ได้เปิดใช้การแก้ปัญหา

  • เครือข่าย

    หมายเลข ไม่บังคับ

    การวัดการใช้งานเครือข่ายกระบวนการล่าสุดในหน่วยไบต์ต่อวินาที ใช้ได้เฉพาะเมื่อได้รับออบเจ็กต์ที่เป็นส่วนหนึ่งของ Callback จาก onUpdated หรือ onUpdatedWithMemory เท่านั้น

  • osProcessId

    ตัวเลข

    รหัสของกระบวนการตามที่ระบบปฏิบัติการระบุไว้

  • privateMemory

    หมายเลข ไม่บังคับ

    การวัดการใช้หน่วยความจำส่วนตัวล่าสุดของกระบวนการในหน่วยไบต์ ใช้ได้เฉพาะเมื่อได้รับออบเจ็กต์ที่เป็นส่วนหนึ่งของ Callback จาก onUpdatedWithMemory หรือ getProcessInfo ที่มีแฟล็ก includeMemory ไว้เท่านั้น

  • โปรไฟล์

    สตริง

    โปรไฟล์ที่เชื่อมโยงกับกระบวนการ

  • scriptCache

    แคช ไม่บังคับ

    ข้อมูลล่าสุดเกี่ยวกับแคชของสคริปต์สำหรับกระบวนการ ใช้ได้เฉพาะเมื่อได้รับออบเจ็กต์ที่เป็นส่วนหนึ่งของ Callback จาก onUpdated หรือ onUpdatedWithMemory เท่านั้น

  • sqliteMemory

    หมายเลข ไม่บังคับ

    การวัดการใช้งานหน่วยความจำ SQLite ล่าสุดของกระบวนการในหน่วยไบต์ ใช้ได้เฉพาะเมื่อได้รับออบเจ็กต์ที่เป็นส่วนหนึ่งของ Callback จาก onUpdated หรือ onUpdatedWithMemory เท่านั้น

  • งาน

    TaskInfo[]

    อาร์เรย์ของ TaskInfos ที่แสดงงานที่ทำงานอยู่ในกระบวนการนี้

  • ประเภท

    ProcessType

    ประเภทของกระบวนการ

ProcessType

ประเภทการประมวลผลของเบราว์เซอร์

ค่าแจกแจง

"เบราว์เซอร์"

"renderer"

"ส่วนขยาย"

"การแจ้งเตือน"

"ปลั๊กอิน"

"ผู้ปฏิบัติงาน"

"nacl"

"service_worker"

"ยูทิลิตี"

"gpu"

"อื่นๆ"

TaskInfo

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

  • tabId

    หมายเลข ไม่บังคับ

    รหัสแท็บที่ไม่บังคับ หากงานนี้แสดงแท็บที่ทำงานอยู่ในกระบวนการแสดงผล

  • title

    สตริง

    ชื่อของงาน

เมธอด

getProcessIdForTab()

สัญญา 
chrome.processes.getProcessIdForTab(
  tabId: number,
  callback?: function,
)

แสดงผลรหัสของกระบวนการแสดงผลสำหรับแท็บที่ระบุ

พารามิเตอร์

  • tabId

    ตัวเลข

    รหัสของแท็บที่มีรหัสการประมวลผลของโหมดแสดงภาพ

  • Callback

    ไม่บังคับ

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

    (processId: number) => void

    • processId

      ตัวเลข

      รหัสการประมวลผลของกระบวนการแสดงผลของแท็บ

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

  • Promise<number>

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

getProcessInfo()

สัญญา 
chrome.processes.getProcessInfo(
  processIds: number | number[],
  includeMemory: boolean,
  callback?: function,
)

เรียกข้อมูลกระบวนการสำหรับรหัสกระบวนการแต่ละรายการที่ระบุ

พารามิเตอร์

  • processIds

    ตัวเลข | ตัวเลข[]

    รายการรหัสกระบวนการหรือรหัสกระบวนการเดียวที่จะแสดงข้อมูลกระบวนการ รายการที่ว่างเปล่าจะแสดงว่ามีการขอกระบวนการทั้งหมด

  • includeMemory

    boolean

    เป็นจริงหากต้องมีการใช้งานหน่วยความจำโดยละเอียด โปรดทราบว่าการรวบรวมข้อมูลการใช้งานหน่วยความจำจะทำให้มีการใช้ CPU มากขึ้นและควรค้นหาเมื่อจำเป็นเท่านั้น

  • Callback

    ไม่บังคับ

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

    (processes: object) => void

    • กระบวนการ

      ออบเจ็กต์

      พจนานุกรมออบเจ็กต์ Process สำหรับแต่ละกระบวนการที่ขอ ซึ่งเป็นกระบวนการย่อยที่เผยแพร่อยู่ของกระบวนการเบราว์เซอร์ปัจจุบัน จัดทำดัชนีโดยรหัสกระบวนการ เมตริกที่ต้องมีการรวมข้อมูลในช่วงเวลาต่างๆ จะไม่แสดงในออบเจ็กต์ Process แต่ละรายการ

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

  • Promise<object>

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

terminate()

สัญญา 
chrome.processes.terminate(
  processId: number,
  callback?: function,
)

ยุติกระบวนการแสดงผลที่ระบุ เทียบเท่ากับการเข้าชม about:crash แต่ไม่เปลี่ยน URL ของแท็บ

พารามิเตอร์

  • processId

    ตัวเลข

    รหัสของกระบวนการที่จะสิ้นสุด

  • Callback

    ไม่บังคับ

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

    (didTerminate: boolean) => void

    • didTerminate

      boolean

      เป็นจริงหากการสิ้นสุดกระบวนการนี้สำเร็จ และเป็นเท็จ

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

  • Promise<boolean>

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

กิจกรรม

onCreated

chrome.processes.onCreated.addListener(
  callback: function,
)

เริ่มทำงานทุกครั้งที่มีการสร้างกระบวนการโดยระบุออบเจ็กต์ corrseponding Process

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

    (process: Process) => void

onExited

chrome.processes.onExited.addListener(
  callback: function,
)

เริ่มทำงานทุกครั้งที่กระบวนการสิ้นสุดลง โดยระบุประเภทของการออก

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

    (processId: number, exitType: number, exitCode: number) => void

    • processId

      ตัวเลข

    • exitType

      ตัวเลข

    • รหัสทางออก

      ตัวเลข

onUnresponsive

chrome.processes.onUnresponsive.addListener(
  callback: function,
)

เริ่มทำงานทุกครั้งที่กระบวนการไม่ตอบสนอง โดยให้ออบเจ็กต์ corrseponding Process

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

    (process: Process) => void

onUpdated

chrome.processes.onUpdated.addListener(
  callback: function,
)

เริ่มทำงานทุกครั้งที่ตัวจัดการงานอัปเดตสถิติกระบวนการ โดยมีพจนานุกรมของออบเจ็กต์กระบวนการที่อัปเดต ซึ่งมีการจัดทำดัชนีโดยรหัสกระบวนการ

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

    (processes: object) => void

    • กระบวนการ

      ออบเจ็กต์

onUpdatedWithMemory

chrome.processes.onUpdatedWithMemory.addListener(
  callback: function,
)

เริ่มทำงานทุกครั้งที่ตัวจัดการงานอัปเดตสถิติกระบวนการ โดยมีพจนานุกรมของออบเจ็กต์กระบวนการที่อัปเดต ซึ่งมีการจัดทำดัชนีโดยรหัสกระบวนการ เหมือนกับ onUpdate ด้วยการเพิ่มรายละเอียดการใช้หน่วยความจำในออบเจ็กต์ Process แต่ละรายการ โปรดทราบว่าการรวบรวมข้อมูลการใช้งานหน่วยความจำจะทำให้มีการใช้ CPU มากขึ้นและควรฟังเมื่อจำเป็นเท่านั้น

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

    (processes: object) => void

    • กระบวนการ

      ออบเจ็กต์