browser.webNavigation

คำอธิบาย

ใช้ chrome.webNavigation API เพื่อรับการแจ้งเตือนเกี่ยวกับสถานะของคำขอการนำทางระหว่างการเดินทาง

สิทธิ์

webNavigation

เมธอดและเหตุการณ์ทั้งหมดของ browser.webNavigation กำหนดให้คุณต้องประกาศสิทธิ์ "webNavigation" ใน ไฟล์ Manifest ของส่วนขยาย เช่น

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

แนวคิดและการใช้งาน

ลำดับเหตุการณ์

สำหรับการนำทางที่เสร็จสมบูรณ์ ระบบจะทริกเกอร์เหตุการณ์ตามลำดับต่อไปนี้

onBeforeNavigate -> onCommitted -> [onDOMContentLoaded] -> onCompleted

ข้อผิดพลาดที่เกิดขึ้นระหว่างกระบวนการจะส่งผลให้เกิดเหตุการณ์ onErrorOccurred สำหรับการนำทางที่เฉพาะเจาะจง ระบบจะไม่ทริกเกอร์เหตุการณ์เพิ่มเติมหลังจาก onErrorOccurred

หากเฟรมที่ไปยังมีเฟรมย่อย ระบบจะเรียกใช้ onCommitted ก่อน ของเฟรมย่อย onBeforeNavigate และจะเรียกใช้ onCompleted หลังจาก onCompleted ของเฟรมย่อยทั้งหมด

หากมีการเปลี่ยนแปลงส่วนอ้างอิงของเฟรม ระบบจะทริกเกอร์เหตุการณ์ onReferenceFragmentUpdated เหตุการณ์นี้จะทริกเกอร์ได้ทุกเมื่อหลังจาก onDOMContentLoaded แม้หลังจาก onCompleted แล้วก็ตาม

หากใช้ History API เพื่อแก้ไขสถานะของเฟรม (เช่น ใช้ history.pushState()) ระบบจะทริกเกอร์เหตุการณ์ onHistoryStateUpdated เหตุการณ์นี้จะทริกเกอร์ได้ทุกเมื่อหลังจาก onDOMContentLoaded

หากการไปยังส่วนต่างๆ กู้คืนหน้าจาก Back-Forward Cache ระบบจะไม่ทริกเกอร์เหตุการณ์ onDOMContentLoaded ระบบจะไม่ทริกเกอร์เหตุการณ์เนื่องจากเนื้อหาโหลดเสร็จแล้วเมื่อเข้าชมหน้าเว็บครั้งแรก

หากทริกเกอร์การนำทางโดยใช้ Chrome ค้นหาทันใจ หรือ Instant Pages ระบบจะสลับหน้าเว็บที่โหลดเสร็จสมบูรณ์ แล้วไปยังแท็บปัจจุบัน ในกรณีนี้ ระบบจะทริกเกอร์เหตุการณ์ onTabReplaced

ความสัมพันธ์กับเหตุการณ์ webRequest

ไม่มีการกำหนดลำดับระหว่างเหตุการณ์ของ webRequest API กับเหตุการณ์ของ webNavigation API เป็นไปได้ว่าระบบจะยังคงได้รับเหตุการณ์ webRequest สำหรับเฟรมที่เริ่มการนำทางใหม่แล้ว หรือการนำทางจะดำเนินการต่อหลังจากที่โหลดทรัพยากรเครือข่ายเสร็จสมบูรณ์แล้วเท่านั้น

โดยทั่วไป เหตุการณ์ webNavigation จะเกี่ยวข้องอย่างใกล้ชิดกับสถานะการนำทางที่แสดง ใน UI ขณะที่เหตุการณ์ webRequest จะสอดคล้องกับสถานะของสแต็กเครือข่ายซึ่งโดยทั่วไป ผู้ใช้จะมองไม่เห็น

รหัสแท็บ

แท็บการนำทางบางแท็บอาจไม่ตรงกับแท็บจริงใน UI ของ Chrome เช่น แท็บที่กำลัง แสดงผลล่วงหน้า คุณเข้าถึงแท็บดังกล่าวไม่ได้โดยใช้ tabs API และขอข้อมูล เกี่ยวกับแท็บเหล่านั้นโดยเรียกใช้ webNavigation.getFrame() หรือ webNavigation.getAllFrames() ไม่ได้ เมื่อมีการสลับแท็บดังกล่าว ระบบจะทริกเกอร์เหตุการณ์ onTabReplaced และแท็บจะเข้าถึงได้ผ่าน API เหล่านี้

การประทับเวลา

โปรดทราบว่าความผิดปกติทางเทคนิคบางอย่างในการจัดการกระบวนการ Chrome ที่แตกต่างกันของระบบปฏิบัติการอาจทำให้นาฬิกาในเบราว์เซอร์เองและกระบวนการของส่วนขยายไม่ตรงกัน ซึ่ง หมายความว่าระบบรับประกันได้ว่า พร็อพเพอร์ตี้ timeStamp ของพร็อพเพอร์ตี้เหตุการณ์ WebNavigation timeStamp จะสอดคล้องกันภายในเท่านั้น การเปรียบเทียบเหตุการณ์หนึ่งกับอีกเหตุการณ์หนึ่งจะทำให้คุณเห็นออฟเซ็ตที่ถูกต้อง ระหว่างเหตุการณ์เหล่านั้น แต่การเปรียบเทียบกับเวลาปัจจุบันภายในส่วนขยาย (เช่น ใช้ (new Date()).getTime()) อาจทำให้ได้ผลลัพธ์ที่ไม่คาดคิด

รหัสเฟรม

คุณระบุเฟรมภายในแท็บได้โดยใช้รหัสเฟรม รหัสเฟรมของเฟรมหลักจะเป็น 0 เสมอ ส่วนรหัสของเฟรมย่อยจะเป็นตัวเลขบวก เมื่อสร้างเอกสารในเฟรมแล้ว รหัสเฟรม จะยังคงเดิมตลอดอายุการใช้งานของเอกสาร ตั้งแต่ Chrome 49 เป็นต้นไป รหัสนี้จะคงที่ตลอดอายุการใช้งานของเฟรม (ในการนำทางหลายครั้ง)

เนื่องจากลักษณะการทำงานแบบหลายกระบวนการของ Chrome แท็บอาจใช้กระบวนการที่แตกต่างกันในการแสดงผลแหล่งที่มา และปลายทางของหน้าเว็บ ดังนั้น หากการนําทางเกิดขึ้นในกระบวนการใหม่ คุณอาจได้รับเหตุการณ์จากทั้งหน้าเว็บใหม่และหน้าเว็บเก่าจนกว่าจะมีการยืนยันการนําทางใหม่ (กล่าวคือ ระบบจะส่งเหตุการณ์ onCommitted สําหรับเฟรมหลักใหม่) กล่าวคือ คุณอาจมีลำดับเหตุการณ์ webNavigation ที่รอดำเนินการมากกว่า 1 รายการที่มี frameId เดียวกัน โดยคุณจะแยกแยะลำดับได้ด้วยprocessId

นอกจากนี้ โปรดทราบว่าในระหว่างการโหลดชั่วคราว กระบวนการอาจเปลี่ยนไปหลายครั้ง ซึ่งจะเกิดขึ้นเมื่อมีการเปลี่ยนเส้นทางการโหลดไปยังเว็บไซต์อื่น ในกรณีนี้ คุณจะได้รับเหตุการณ์ onBeforeNavigate และ onErrorOccurred ซ้ำๆ จนกว่าจะได้รับเหตุการณ์ onCommitted สุดท้าย

อีกแนวคิดหนึ่งที่ทำให้เกิดปัญหาเกี่ยวกับส่วนขยายคือวงจรของเฟรม เฟรมจะโฮสต์เอกสาร (ซึ่งเชื่อมโยงกับ URL ที่คอมมิตแล้ว) เอกสารอาจเปลี่ยนแปลงได้ (เช่น โดยการไปยังส่วนต่างๆ) แต่ frameId จะไม่เปลี่ยนแปลง ดังนั้นจึง ยากที่จะเชื่อมโยงเหตุการณ์ที่เกิดขึ้นในเอกสารหนึ่งๆ กับ frameId เพียงอย่างเดียว เราขอแนะนำแนวคิดเกี่ยวกับ documentId ซึ่งเป็นตัวระบุที่ไม่ซ้ำกันต่อเอกสาร หากมีการไปยังเฟรมและเปิด เอกสารใหม่ ตัวระบุจะเปลี่ยนไป ฟิลด์นี้มีประโยชน์ในการพิจารณา เมื่อหน้าเว็บเปลี่ยนสถานะวงจร (ระหว่างสถานะแสดงตัวอย่างล่วงหน้า/ใช้งานอยู่/แคช) เนื่องจากยังคงเหมือนเดิม

ประเภทการเปลี่ยนและตัวระบุ

เหตุการณ์ webNavigation onCommitted มีพร็อพเพอร์ตี้ transitionType และ transitionQualifiers ประเภทการเปลี่ยนเส้นทางจะเหมือนกับที่ใช้ใน History API ซึ่งอธิบายวิธีที่เบราว์เซอร์ไปยัง URL นี้ นอกจากนี้ ยังสามารถแสดงตัวระบุการเปลี่ยนผ่านหลายรายการ ซึ่งจะกำหนดการนำทางเพิ่มเติมได้

คุณสมบัติในการเปลี่ยนรุ่นมีดังนี้

ตัวระบุการเปลี่ยนคำอธิบาย
"client_redirect"การเปลี่ยนเส้นทางอย่างน้อย 1 รายการที่เกิดจากแท็ก JavaScript หรือแท็กการรีเฟรชเมตาในหน้าเว็บเกิดขึ้นระหว่างการนำทาง
"server_redirect"การเปลี่ยนเส้นทางอย่างน้อย 1 รายการที่เกิดจากส่วนหัว HTTP ที่ส่งจากเซิร์ฟเวอร์เกิดขึ้นระหว่างการนำทาง
"forward_back"ผู้ใช้ใช้ปุ่มไปข้างหน้าหรือปุ่มย้อนกลับเพื่อเริ่มการไปยังส่วนต่างๆ
"from_address_bar"ผู้ใช้เริ่มการนำทางจากแถบที่อยู่ (หรือที่เรียกว่าแถบอเนกประสงค์)

ตัวอย่าง

หากต้องการลองใช้ API นี้ ให้ติดตั้งตัวอย่าง API การนำทางบนเว็บจากที่เก็บ chrome-extension-samples

ประเภท

TransitionQualifier

Chrome 44 ขึ้นไป

ค่าแจกแจง

"client_redirect"

"server_redirect"

"forward_back"

"from_address_bar"

TransitionType

Chrome 44 ขึ้นไป

สาเหตุของการนำทาง ใช้การเปลี่ยนประเภทเดียวกันตามที่กำหนดไว้ใน History API ซึ่งเป็นประเภทการเปลี่ยนเส้นทางเดียวกันกับที่กำหนดไว้ใน History API ยกเว้นว่ามี "start_page" แทน "auto_toplevel" (เพื่อความเข้ากันได้แบบย้อนกลับ)

ค่าแจกแจง

"ลิงก์"

"พิมพ์"

"auto_bookmark"

"auto_subframe"

"manual_subframe"

"สร้างขึ้น"

"start_page"

"form_submit"

"reload"

"คีย์เวิร์ด"

"keyword_generated"

เมธอด

getAllFrames()

chrome.webNavigation.getAllFrames(
  details: object,
): Promise<object[] | undefined>

เรียกข้อมูลเกี่ยวกับเฟรมทั้งหมดของแท็บที่ระบุ

พารามิเตอร์

  • รายละเอียด

    ออบเจ็กต์

    ข้อมูลเกี่ยวกับแท็บที่จะดึงเฟรมทั้งหมดจาก

    • tabId

      ตัวเลข

      รหัสของแท็บ

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

  • Promise<object[] | undefined>

    Chrome 93 ขึ้นไป

getFrame()

chrome.webNavigation.getFrame(
  details: object,
): Promise<object | undefined>

เรียกข้อมูลเกี่ยวกับเฟรมที่ระบุ เฟรมหมายถึง <iframe> หรือ <frame> ของหน้าเว็บ และระบุด้วยรหัสแท็บและรหัสเฟรม

พารามิเตอร์

  • รายละเอียด

    ออบเจ็กต์

    ข้อมูลเกี่ยวกับเฟรมที่จะดึงข้อมูล

    • documentId

      สตริง ไม่บังคับ

      Chrome 106 ขึ้นไป

      UUID ของเอกสาร หากมีการระบุ frameId และ/หรือ tabId ระบบจะตรวจสอบว่าตรงกับเอกสารที่พบตามรหัสเอกสารที่ระบุหรือไม่

    • frameId

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

      รหัสของเฟรมในแท็บที่ระบุ

    • processId

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

      เลิกใช้งานตั้งแต่ Chrome 49

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

      รหัสของกระบวนการที่เรียกใช้โปรแกรมแสดงผลสำหรับแท็บนี้

    • tabId

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

      รหัสของแท็บที่มีเฟรม

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

  • Promise<object | undefined>

    Chrome 93 ขึ้นไป

กิจกรรม

onBeforeNavigate

chrome.webNavigation.onBeforeNavigate.addListener(
  callback: function,
  filters?: object,
)

ทริกเกอร์เมื่อกำลังจะเกิดการนำทาง

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (details: object) => void

    • รายละเอียด

      ออบเจ็กต์

      • Chrome 106 ขึ้นไป

        วงจรที่เอกสารอยู่

      • frameId

        ตัวเลข

        0 หมายความว่าการนำทางเกิดขึ้นในหน้าต่างเนื้อหาของแท็บ ส่วนค่าบวกหมายความว่าการนำทางเกิดขึ้นในเฟรมย่อย รหัสเฟรมจะไม่ซ้ำกันสำหรับแท็บและกระบวนการที่กำหนด

      • Chrome 106 ขึ้นไป

        ประเภทเฟรมที่มีการนำทาง

      • parentDocumentId

        สตริง ไม่บังคับ

        Chrome 106 ขึ้นไป

        UUID ของเอกสารหลักที่เป็นเจ้าของเฟรมนี้ ไม่ได้ตั้งค่าหากไม่มีองค์กรหลัก

      • parentFrameId

        ตัวเลข

        รหัสของเฟรมหลัก หรือ -1 หากเป็นเฟรมหลัก

      • processId

        ตัวเลข

        เลิกใช้งานตั้งแต่ Chrome 50

        ระบบจะไม่ตั้งค่า processId สำหรับเหตุการณ์นี้อีกต่อไป เนื่องจากไม่ทราบกระบวนการที่จะแสดงเอกสารผลลัพธ์จนกว่าจะถึง onCommit

        ค่า -1

      • tabId

        ตัวเลข

        รหัสของแท็บที่จะเกิดการนำทาง

      • timeStamp

        ตัวเลข

        เวลาที่เบราว์เซอร์กำลังจะเริ่มการนำทาง หน่วยเป็นมิลลิวินาทีที่เริ่มนับมาตั้งแต่วันที่ 1 มกราคม ค.ศ. 1970

      • URL

        สตริง

  • ตัวกรอง

    ออบเจ็กต์ ไม่บังคับ

    • เงื่อนไขที่ URL ที่กำลังไปยังต้องเป็นไปตาม

onCommitted

chrome.webNavigation.onCommitted.addListener(
  callback: function,
  filters?: object,
)

เริ่มทำงานเมื่อมีการนำทาง เอกสาร (และทรัพยากรที่เอกสารอ้างอิงถึง เช่น รูปภาพและเฟรมย่อย) อาจยังคงดาวน์โหลดอยู่ แต่ระบบได้รับเอกสารอย่างน้อยบางส่วนจากเซิร์ฟเวอร์แล้ว และเบราว์เซอร์ตัดสินใจที่จะเปลี่ยนไปใช้เอกสารใหม่

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (details: object) => void

    • รายละเอียด

      ออบเจ็กต์

      • documentId

        สตริง

        Chrome 106 ขึ้นไป

        UUID ของเอกสารที่โหลด

      • Chrome 106 ขึ้นไป

        วงจรที่เอกสารอยู่

      • frameId

        ตัวเลข

        0 หมายความว่าการนำทางเกิดขึ้นในหน้าต่างเนื้อหาของแท็บ ส่วนค่าบวกหมายความว่าการนำทางเกิดขึ้นในเฟรมย่อย รหัสเฟรมจะไม่ซ้ำกันภายในแท็บ

      • Chrome 106 ขึ้นไป

        ประเภทเฟรมที่มีการนำทาง

      • parentDocumentId

        สตริง ไม่บังคับ

        Chrome 106 ขึ้นไป

        UUID ของเอกสารหลักที่เป็นเจ้าของเฟรมนี้ ไม่ได้ตั้งค่าหากไม่มีองค์กรหลัก

      • parentFrameId

        ตัวเลข

        Chrome 74 ขึ้นไป

        รหัสของเฟรมหลัก หรือ -1 หากเป็นเฟรมหลัก

      • processId

        ตัวเลข

        รหัสของกระบวนการที่เรียกใช้โปรแกรมแสดงผลสำหรับเฟรมนี้

      • tabId

        ตัวเลข

        รหัสของแท็บที่มีการไปยังส่วนต่างๆ

      • timeStamp

        ตัวเลข

        เวลาที่การนำทางได้รับการยืนยัน หน่วยเป็นมิลลิวินาทีตั้งแต่ Epoch

      • transitionQualifiers

        TransitionQualifier[]

        รายการตัวระบุการเปลี่ยน

      • transitionType

        TransitionType

        สาเหตุของการนำทาง

      • URL

        สตริง

  • ตัวกรอง

    ออบเจ็กต์ ไม่บังคับ

    • เงื่อนไขที่ URL ที่กำลังไปยังต้องเป็นไปตาม

onCompleted

chrome.webNavigation.onCompleted.addListener(
  callback: function,
  filters?: object,
)

ทริกเกอร์เมื่อโหลดและเริ่มต้นเอกสาร รวมถึงทรัพยากรที่เอกสารอ้างอิงถึงอย่างสมบูรณ์

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (details: object) => void

    • รายละเอียด

      ออบเจ็กต์

      • documentId

        สตริง

        Chrome 106 ขึ้นไป

        UUID ของเอกสารที่โหลด

      • Chrome 106 ขึ้นไป

        วงจรที่เอกสารอยู่

      • frameId

        ตัวเลข

        0 หมายความว่าการนำทางเกิดขึ้นในหน้าต่างเนื้อหาของแท็บ ส่วนค่าบวกหมายความว่าการนำทางเกิดขึ้นในเฟรมย่อย รหัสเฟรมจะไม่ซ้ำกันภายในแท็บ

      • Chrome 106 ขึ้นไป

        ประเภทเฟรมที่มีการนำทาง

      • parentDocumentId

        สตริง ไม่บังคับ

        Chrome 106 ขึ้นไป

        UUID ของเอกสารหลักที่เป็นเจ้าของเฟรมนี้ ไม่ได้ตั้งค่าหากไม่มีองค์กรหลัก

      • parentFrameId

        ตัวเลข

        Chrome 74 ขึ้นไป

        รหัสของเฟรมหลัก หรือ -1 หากเป็นเฟรมหลัก

      • processId

        ตัวเลข

        รหัสของกระบวนการที่เรียกใช้โปรแกรมแสดงผลสำหรับเฟรมนี้

      • tabId

        ตัวเลข

        รหัสของแท็บที่มีการไปยังส่วนต่างๆ

      • timeStamp

        ตัวเลข

        เวลาที่เอกสารโหลดเสร็จสมบูรณ์ หน่วยเป็นมิลลิวินาทีตั้งแต่ Epoch

      • URL

        สตริง

  • ตัวกรอง

    ออบเจ็กต์ ไม่บังคับ

    • เงื่อนไขที่ URL ที่กำลังไปยังต้องเป็นไปตาม

onCreatedNavigationTarget

chrome.webNavigation.onCreatedNavigationTarget.addListener(
  callback: function,
  filters?: object,
)

ทริกเกอร์เมื่อมีการสร้างหน้าต่างใหม่หรือแท็บใหม่ในหน้าต่างที่มีอยู่เพื่อโฮสต์การนำทาง

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (details: object) => void

    • รายละเอียด

      ออบเจ็กต์

      • sourceFrameId

        ตัวเลข

        รหัสของเฟรมที่มี sourceTabId ซึ่งทริกเกอร์การนำทาง 0 หมายถึงเฟรมหลัก

      • sourceProcessId

        ตัวเลข

        รหัสของกระบวนการที่เรียกใช้โปรแกรมแสดงผลสำหรับเฟรมแหล่งที่มา

      • sourceTabId

        ตัวเลข

        รหัสของแท็บที่มีการทริกเกอร์การนำทาง

      • tabId

        ตัวเลข

        รหัสของแท็บที่เปิด URL

      • timeStamp

        ตัวเลข

        เวลาที่เบราว์เซอร์กำลังจะสร้างมุมมองใหม่เป็นมิลลิวินาทีนับตั้งแต่ Epoch

      • URL

        สตริง

        URL ที่จะเปิดในหน้าต่างใหม่

  • ตัวกรอง

    ออบเจ็กต์ ไม่บังคับ

    • เงื่อนไขที่ URL ที่กำลังไปยังต้องเป็นไปตาม

onDOMContentLoaded

chrome.webNavigation.onDOMContentLoaded.addListener(
  callback: function,
  filters?: object,
)

ทริกเกอร์เมื่อสร้าง DOM ของหน้าเว็บเสร็จสมบูรณ์แล้ว แต่ทรัพยากรที่อ้างอิงอาจโหลดไม่เสร็จ

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (details: object) => void

    • รายละเอียด

      ออบเจ็กต์

      • documentId

        สตริง

        Chrome 106 ขึ้นไป

        UUID ของเอกสารที่โหลด

      • Chrome 106 ขึ้นไป

        วงจรที่เอกสารอยู่

      • frameId

        ตัวเลข

        0 หมายความว่าการนำทางเกิดขึ้นในหน้าต่างเนื้อหาของแท็บ ส่วนค่าบวกหมายความว่าการนำทางเกิดขึ้นในเฟรมย่อย รหัสเฟรมจะไม่ซ้ำกันภายในแท็บ

      • Chrome 106 ขึ้นไป

        ประเภทเฟรมที่มีการนำทาง

      • parentDocumentId

        สตริง ไม่บังคับ

        Chrome 106 ขึ้นไป

        UUID ของเอกสารหลักที่เป็นเจ้าของเฟรมนี้ ไม่ได้ตั้งค่าหากไม่มีองค์กรหลัก

      • parentFrameId

        ตัวเลข

        Chrome 74 ขึ้นไป

        รหัสของเฟรมหลัก หรือ -1 หากเป็นเฟรมหลัก

      • processId

        ตัวเลข

        รหัสของกระบวนการที่เรียกใช้โปรแกรมแสดงผลสำหรับเฟรมนี้

      • tabId

        ตัวเลข

        รหัสของแท็บที่มีการไปยังส่วนต่างๆ

      • timeStamp

        ตัวเลข

        เวลาที่สร้าง DOM ของหน้าเว็บเสร็จสมบูรณ์แล้วเป็นมิลลิวินาทีตั้งแต่ Epoch

      • URL

        สตริง

  • ตัวกรอง

    ออบเจ็กต์ ไม่บังคับ

    • เงื่อนไขที่ URL ที่กำลังไปยังต้องเป็นไปตาม

onErrorOccurred

chrome.webNavigation.onErrorOccurred.addListener(
  callback: function,
  filters?: object,
)

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

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (details: object) => void

    • รายละเอียด

      ออบเจ็กต์

      • documentId

        สตริง

        Chrome 106 ขึ้นไป

        UUID ของเอกสารที่โหลด

      • Chrome 106 ขึ้นไป

        วงจรที่เอกสารอยู่

      • ข้อผิดพลาด

        สตริง

        คำอธิบายข้อผิดพลาด

      • frameId

        ตัวเลข

        0 หมายความว่าการนำทางเกิดขึ้นในหน้าต่างเนื้อหาของแท็บ ส่วนค่าบวกหมายความว่าการนำทางเกิดขึ้นในเฟรมย่อย รหัสเฟรมจะไม่ซ้ำกันภายในแท็บ

      • Chrome 106 ขึ้นไป

        ประเภทเฟรมที่มีการนำทาง

      • parentDocumentId

        สตริง ไม่บังคับ

        Chrome 106 ขึ้นไป

        UUID ของเอกสารหลักที่เป็นเจ้าของเฟรมนี้ ไม่ได้ตั้งค่าหากไม่มีองค์กรหลัก

      • parentFrameId

        ตัวเลข

        Chrome 74 ขึ้นไป

        รหัสของเฟรมหลัก หรือ -1 หากเป็นเฟรมหลัก

      • processId

        ตัวเลข

        เลิกใช้งานตั้งแต่ Chrome 50

        ระบบจะไม่ตั้งค่า processId สำหรับเหตุการณ์นี้อีกต่อไป

        ค่า -1

      • tabId

        ตัวเลข

        รหัสของแท็บที่มีการไปยังส่วนต่างๆ

      • timeStamp

        ตัวเลข

        เวลาที่เกิดข้อผิดพลาดในหน่วยมิลลิวินาทีตั้งแต่ Epoch

      • URL

        สตริง

  • ตัวกรอง

    ออบเจ็กต์ ไม่บังคับ

    • เงื่อนไขที่ URL ที่กำลังไปยังต้องเป็นไปตาม

onHistoryStateUpdated

chrome.webNavigation.onHistoryStateUpdated.addListener(
  callback: function,
  filters?: object,
)

ทริกเกอร์เมื่อประวัติของเฟรมได้รับการอัปเดตเป็น URL ใหม่ กิจกรรมในอนาคตทั้งหมดสำหรับเฟรมนั้นจะใช้ URL ที่อัปเดต

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (details: object) => void

    • รายละเอียด

      ออบเจ็กต์

      • documentId

        สตริง

        Chrome 106 ขึ้นไป

        UUID ของเอกสารที่โหลด

      • Chrome 106 ขึ้นไป

        วงจรที่เอกสารอยู่

      • frameId

        ตัวเลข

        0 หมายความว่าการนำทางเกิดขึ้นในหน้าต่างเนื้อหาของแท็บ ส่วนค่าบวกหมายความว่าการนำทางเกิดขึ้นในเฟรมย่อย รหัสเฟรมจะไม่ซ้ำกันภายในแท็บ

      • Chrome 106 ขึ้นไป

        ประเภทเฟรมที่มีการนำทาง

      • parentDocumentId

        สตริง ไม่บังคับ

        Chrome 106 ขึ้นไป

        UUID ของเอกสารหลักที่เป็นเจ้าของเฟรมนี้ ไม่ได้ตั้งค่าหากไม่มีองค์กรหลัก

      • parentFrameId

        ตัวเลข

        Chrome 74 ขึ้นไป

        รหัสของเฟรมหลัก หรือ -1 หากเป็นเฟรมหลัก

      • processId

        ตัวเลข

        รหัสของกระบวนการที่เรียกใช้โปรแกรมแสดงผลสำหรับเฟรมนี้

      • tabId

        ตัวเลข

        รหัสของแท็บที่มีการไปยังส่วนต่างๆ

      • timeStamp

        ตัวเลข

        เวลาที่การนำทางได้รับการยืนยัน หน่วยเป็นมิลลิวินาทีตั้งแต่ Epoch

      • transitionQualifiers

        TransitionQualifier[]

        รายการตัวระบุการเปลี่ยน

      • transitionType

        TransitionType

        สาเหตุของการนำทาง

      • URL

        สตริง

  • ตัวกรอง

    ออบเจ็กต์ ไม่บังคับ

    • เงื่อนไขที่ URL ที่กำลังไปยังต้องเป็นไปตาม

onReferenceFragmentUpdated

chrome.webNavigation.onReferenceFragmentUpdated.addListener(
  callback: function,
  filters?: object,
)

ทริกเกอร์เมื่อมีการอัปเดต Fragment อ้างอิงของเฟรม กิจกรรมในอนาคตทั้งหมดสำหรับเฟรมนั้นจะใช้ URL ที่อัปเดต

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (details: object) => void

    • รายละเอียด

      ออบเจ็กต์

      • documentId

        สตริง

        Chrome 106 ขึ้นไป

        UUID ของเอกสารที่โหลด

      • Chrome 106 ขึ้นไป

        วงจรที่เอกสารอยู่

      • frameId

        ตัวเลข

        0 หมายความว่าการนำทางเกิดขึ้นในหน้าต่างเนื้อหาของแท็บ ส่วนค่าบวกหมายความว่าการนำทางเกิดขึ้นในเฟรมย่อย รหัสเฟรมจะไม่ซ้ำกันภายในแท็บ

      • Chrome 106 ขึ้นไป

        ประเภทเฟรมที่มีการนำทาง

      • parentDocumentId

        สตริง ไม่บังคับ

        Chrome 106 ขึ้นไป

        UUID ของเอกสารหลักที่เป็นเจ้าของเฟรมนี้ ไม่ได้ตั้งค่าหากไม่มีองค์กรหลัก

      • parentFrameId

        ตัวเลข

        Chrome 74 ขึ้นไป

        รหัสของเฟรมหลัก หรือ -1 หากเป็นเฟรมหลัก

      • processId

        ตัวเลข

        รหัสของกระบวนการที่เรียกใช้โปรแกรมแสดงผลสำหรับเฟรมนี้

      • tabId

        ตัวเลข

        รหัสของแท็บที่มีการไปยังส่วนต่างๆ

      • timeStamp

        ตัวเลข

        เวลาที่การนำทางได้รับการยืนยัน หน่วยเป็นมิลลิวินาทีตั้งแต่ Epoch

      • transitionQualifiers

        TransitionQualifier[]

        รายการตัวระบุการเปลี่ยน

      • transitionType

        TransitionType

        สาเหตุของการนำทาง

      • URL

        สตริง

  • ตัวกรอง

    ออบเจ็กต์ ไม่บังคับ

    • เงื่อนไขที่ URL ที่กำลังไปยังต้องเป็นไปตาม

onTabReplaced

chrome.webNavigation.onTabReplaced.addListener(
  callback: function,
)

ทริกเกอร์เมื่อเนื้อหาของแท็บถูกแทนที่ด้วยแท็บอื่น (โดยปกติจะเป็นแท็บที่แสดงผลล่วงหน้าก่อนหน้านี้)

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (details: object) => void

    • รายละเอียด

      ออบเจ็กต์

      • replacedTabId

        ตัวเลข

        รหัสของแท็บที่ถูกแทนที่

      • tabId

        ตัวเลข

        รหัสของแท็บที่แทนที่แท็บเก่า

      • timeStamp

        ตัวเลข

        เวลาที่เกิดการแทนที่ในหน่วยมิลลิวินาทีตั้งแต่ Epoch