chrome.webNavigation

refresh date: 2026-09-25 robots: noindex

Mô tả

Sử dụng API chrome.webNavigation để nhận thông báo về trạng thái của các yêu cầu điều hướng đang diễn ra.

Quyền

webNavigation

Tệp kê khai

Tất cả phương thức và sự kiện chrome.webNavigation đều yêu cầu bạn khai báo quyền "webNavigation" trong tệp kê khai tiện ích. Ví dụ:

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

Thứ tự sự kiện

Đối với một thao tác điều hướng hoàn tất thành công, các sự kiện sẽ được kích hoạt theo thứ tự sau:

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

Mọi lỗi xảy ra trong quá trình này đều dẫn đến sự kiện onErrorOccurred. Đối với một thao tác điều hướng cụ thể, không có sự kiện nào khác được kích hoạt sau onErrorOccurred.

Nếu một khung điều hướng chứa các khung phụ, thì onCommitted của khung đó sẽ được kích hoạt trước bất kỳ onBeforeNavigate nào của khung con; trong khi onCompleted được kích hoạt sau tất cả onCompleted của khung con.

Nếu mảnh tham chiếu của một khung hình thay đổi, thì sự kiện onReferenceFragmentUpdated sẽ được kích hoạt. Sự kiện này có thể kích hoạt bất cứ lúc nào sau onDOMContentLoaded, thậm chí sau onCompleted.

Nếu API nhật ký được dùng để sửa đổi trạng thái của một khung (ví dụ: sử dụng history.pushState()), thì sự kiện onHistoryStateUpdated sẽ được kích hoạt. Sự kiện này có thể kích hoạt bất cứ lúc nào sau onDOMContentLoaded.

Nếu một thao tác di chuyển khôi phục một trang từ Bộ nhớ đệm cho thao tác tiến/lùi, thì sự kiện onDOMContentLoaded sẽ không kích hoạt. Sự kiện này không được kích hoạt vì nội dung đã hoàn tất tải khi trang được truy cập lần đầu tiên.

Nếu một thao tác điều hướng được kích hoạt thông qua Chrome Instant hoặc Instant Pages, thì một trang đã tải hoàn toàn sẽ được hoán đổi vào thẻ hiện tại. Trong trường hợp đó, sự kiện onTabReplaced sẽ được kích hoạt.

Mối quan hệ với sự kiện webRequest

Không có thứ tự xác định giữa các sự kiện của webRequest API và các sự kiện của webNavigation API. Có thể các sự kiện webRequest vẫn được nhận cho những khung đã bắt đầu một hoạt động điều hướng mới hoặc một hoạt động điều hướng chỉ tiếp tục sau khi tài nguyên mạng đã được tải đầy đủ.

Nhìn chung, các sự kiện webNavigation có liên quan chặt chẽ đến trạng thái điều hướng hiển thị trong giao diện người dùng, trong khi các sự kiện webRequest tương ứng với trạng thái của bộ phần cứng và phần mềm mạng mà người dùng thường không nhìn thấy.

Mã thẻ

Không phải thẻ điều hướng nào cũng tương ứng với thẻ thực tế trong giao diện người dùng của Chrome, ví dụ: thẻ đang được kết xuất trước. Bạn không thể truy cập vào các thẻ như vậy thông qua API thẻ, cũng như không thể yêu cầu thông tin về các thẻ đó thông qua webNavigation.getFrame hoặc webNavigation.getAllFrames. Sau khi một thẻ như vậy được hoán đổi, sự kiện onTabReplaced sẽ được kích hoạt và các thẻ này có thể truy cập được thông qua các API này.

Dấu thời gian

Điều quan trọng cần lưu ý là một số điểm bất thường về kỹ thuật trong cách hệ điều hành xử lý các quy trình riêng biệt của Chrome có thể khiến đồng hồ bị lệch giữa chính trình duyệt và các quy trình của tiện ích. Điều đó có nghĩa là thuộc tính timeStamp của sự kiện WebNavigation chỉ được đảm bảo nhất quán trong nội bộ. Việc so sánh một sự kiện với một sự kiện khác sẽ cho bạn biết độ lệch chính xác giữa các sự kiện đó, nhưng việc so sánh các sự kiện đó với thời gian hiện tại bên trong tiện ích (ví dụ: thông qua (new Date()).getTime()) có thể cho ra kết quả không mong muốn.

Mã khung

Bạn có thể xác định các khung trong một thẻ bằng mã khung. Mã khung của khung chính luôn là 0, mã nhận dạng của khung con là một số dương. Sau khi một tài liệu được tạo trong một khung, mã khung của tài liệu đó sẽ không thay đổi trong suốt thời gian hoạt động của tài liệu. Kể từ Chrome 49, mã nhận dạng này cũng không đổi trong suốt thời gian hoạt động của khung (trên nhiều thao tác điều hướng).

Do tính chất đa quy trình của Chrome, một thẻ có thể sử dụng nhiều quy trình để kết xuất nguồn và đích của một trang web. Do đó, nếu thao tác điều hướng diễn ra trong một quy trình mới, bạn có thể nhận được sự kiện từ cả trang mới và trang cũ cho đến khi thao tác điều hướng mới được thực hiện (tức là sự kiện onCommitted được gửi cho khung chính mới). Nói cách khác, có thể có nhiều chuỗi sự kiện webNavigation đang chờ xử lý có cùng frameId. Bạn có thể phân biệt các trình tự bằng khoá processId.

Cũng xin lưu ý rằng trong quá trình tải tạm thời, quy trình có thể được chuyển đổi nhiều lần. Điều này xảy ra khi lượt tải được chuyển hướng đến một trang web khác. Trong trường hợp này, bạn sẽ nhận được các sự kiện onBeforeNavigate và onErrorOccurred lặp lại cho đến khi nhận được sự kiện onCommitted cuối cùng.

Một khái niệm khác có vấn đề với tiện ích là vòng đời của khung. Một khung lưu trữ một tài liệu (được liên kết với một URL đã cam kết). Tài liệu có thể thay đổi (ví dụ: bằng cách điều hướng) nhưng frameId thì không, vì vậy, rất khó để liên kết một sự kiện xảy ra trong một tài liệu cụ thể chỉ bằng frameId. Chúng tôi sẽ giới thiệu khái niệm documentId, tức là giá trị nhận dạng riêng biệt cho mỗi tài liệu. Nếu một khung được điều hướng và mở một tài liệu mới, thì giá trị nhận dạng sẽ thay đổi. Trường này hữu ích cho việc xác định thời điểm các trang thay đổi trạng thái vòng đời (giữa trạng thái kết xuất trước/đang hoạt động/đã lưu vào bộ nhớ đệm) vì trường này không thay đổi.

Loại chuyển đổi và bộ hạn định

Sự kiện onCommitted của webNavigation API có thuộc tính transitionType và transitionQualifiers. Loại chuyển đổi giống với loại được dùng trong API nhật ký mô tả cách trình duyệt chuyển đến URL cụ thể này. Ngoài ra, bạn có thể trả về một số bộ hạn định chuyển đổi để xác định rõ hơn về hoạt động điều hướng.

Có các bộ hạn định chuyển đổi sau:

Vòng loại môn chuyển tiếpMô tả
"client_redirect"Một hoặc nhiều lệnh chuyển hướng do JavaScript hoặc thẻ meta refresh trên trang gây ra đã xảy ra trong quá trình điều hướng.
"server_redirect"Một hoặc nhiều lệnh chuyển hướng do tiêu đề HTTP gửi từ máy chủ đã xảy ra trong quá trình điều hướng.
"forward_back"Người dùng đã sử dụng nút Tiến hoặc nút quay lại để bắt đầu thao tác Điều hướng.
"from_address_bar"Người dùng đã bắt đầu thao tác điều hướng từ thanh địa chỉ (còn gọi là Thanh địa chỉ).

Ví dụ

Để dùng thử API này, hãy cài đặt ví dụ về API webNavigation từ kho lưu trữ chrome-extension-samples.

Loại

TransitionQualifier

Chrome 44 trở lên

Enum

"client_redirect"

"server_redirect"

"forward_back"

"from_address_bar"

TransitionType

Chrome 44 trở lên

Nguyên nhân của thao tác điều hướng. Các loại chuyển đổi tương tự như được xác định trong API nhật ký sẽ được sử dụng. Đây là các loại chuyển đổi giống như được xác định trong API nhật ký, ngoại trừ việc "start_page" thay thế cho "auto_toplevel" (để đảm bảo khả năng tương thích ngược).

Enum

"link"

"typed"

"auto_bookmark"

"auto_subframe"

"manual_subframe"

"generated"

"start_page"

"form_submit"

"reload"

"keyword"

"keyword_generated"

Phương thức

getAllFrames()

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

Truy xuất thông tin về tất cả khung của một thẻ nhất định.

Thông số

  • chi tiết

    đối tượng

    Thông tin về thẻ để truy xuất tất cả khung.

    • tabId

      số

      Mã của thẻ.

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    (details?: object[]) => void

    • chi tiết

      object[] không bắt buộc

      Danh sách khung trong thẻ đã cho, rỗng nếu mã thẻ được chỉ định không hợp lệ.

      • documentId

        chuỗi

        Chrome 106 trở lên

        UUID của tài liệu đã tải.

      • documentLifecycle

        DocumentLifecycle

        Chrome 106 trở lên

        Vòng đời của tài liệu.

      • errorOccurred

        boolean

        Đúng nếu lần điều hướng gần đây nhất trong khung này bị gián đoạn do lỗi, tức là sự kiện onErrorOccurred đã kích hoạt.

      • frameId

        số

        Mã nhận dạng của khung hình. 0 cho biết đây là khung chính; giá trị dương cho biết mã nhận dạng của khung phụ.

      • frameType

        FrameType

        Chrome 106 trở lên

        Loại khung mà thao tác di chuyển đã diễn ra.

      • parentDocumentId

        chuỗi không bắt buộc

        Chrome 106 trở lên

        UUID của tài liệu mẹ sở hữu khung này. Trường này không được đặt nếu không có phần tử mẹ.

      • parentFrameId

        số

        Mã nhận dạng của khung mẹ hoặc -1 nếu đây là khung chính.

      • processId

        số

        Mã nhận dạng của quy trình chạy trình kết xuất cho khung này.

      • url

        chuỗi

        URL hiện được liên kết với khung này.

Giá trị trả về

  • Promise<object[] | undefined>

    Chrome 93 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getFrame()

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

Truy xuất thông tin về khung hình đã cho. Khung là một <iframe> hoặc <frame> của một trang web và được xác định bằng mã nhận dạng thẻ và mã nhận dạng khung.

Thông số

  • chi tiết

    đối tượng

    Thông tin về khung hình cần truy xuất thông tin.

    • documentId

      chuỗi không bắt buộc

      Chrome 106 trở lên

      UUID của tài liệu. Nếu frameId và/hoặc tabId được cung cấp, thì các giá trị này sẽ được xác thực để khớp với tài liệu được tìm thấy theo mã tài liệu được cung cấp.

    • frameId

      number không bắt buộc

      Mã nhận dạng của khung trong thẻ đã cho.

    • processId

      number không bắt buộc

      Ngừng sử dụng kể từ Chrome 49

      Giờ đây, các khung được xác định riêng biệt bằng mã nhận dạng thẻ và mã nhận dạng khung; mã định danh tiến trình không còn cần thiết nữa nên sẽ bị bỏ qua.

      Mã của quy trình chạy trình kết xuất cho thẻ này.

    • tabId

      number không bắt buộc

      Mã nhận dạng của thẻ chứa khung.

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    (details?: object) => void

    • chi tiết

      object không bắt buộc

      Thông tin về khung hình được yêu cầu, rỗng nếu mã khung hình và/hoặc mã thẻ được chỉ định không hợp lệ.

      • documentId

        chuỗi

        Chrome 106 trở lên

        UUID của tài liệu đã tải.

      • documentLifecycle

        DocumentLifecycle

        Chrome 106 trở lên

        Vòng đời của tài liệu.

      • errorOccurred

        boolean

        Đúng nếu lần điều hướng gần đây nhất trong khung này bị gián đoạn do lỗi, tức là sự kiện onErrorOccurred đã kích hoạt.

      • frameType

        FrameType

        Chrome 106 trở lên

        Loại khung mà thao tác di chuyển đã diễn ra.

      • parentDocumentId

        chuỗi không bắt buộc

        Chrome 106 trở lên

        UUID của tài liệu mẹ sở hữu khung này. Trường này không được đặt nếu không có phần tử mẹ.

      • parentFrameId

        số

        Mã nhận dạng của khung mẹ hoặc -1 nếu đây là khung chính.

      • url

        chuỗi

        URL hiện được liên kết với khung này, nếu khung được xác định bằng frameId tồn tại tại một thời điểm trong thẻ đã cho. Việc một URL được liên kết với một frameId nhất định không có nghĩa là khung tương ứng vẫn tồn tại.

Giá trị trả về

  • Promise<object | undefined>

    Chrome 93 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

Sự kiện

onBeforeNavigate

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

Được kích hoạt khi sắp xảy ra thao tác điều hướng.

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

    (details: object) => void

    • chi tiết

      đối tượng

      • Chrome 106 trở lên

        Vòng đời của tài liệu.

      • frameId

        số

        0 cho biết thao tác điều hướng xảy ra trong cửa sổ nội dung thẻ; giá trị dương cho biết thao tác điều hướng trong khung phụ. Mã khung là duy nhất cho một thẻ và quy trình nhất định.

      • Chrome 106 trở lên

        Loại khung mà thao tác di chuyển đã diễn ra.

      • parentDocumentId

        chuỗi không bắt buộc

        Chrome 106 trở lên

        UUID của tài liệu mẹ sở hữu khung này. Trường này không được đặt nếu không có phần tử mẹ.

      • parentFrameId

        số

        Mã nhận dạng của khung mẹ hoặc -1 nếu đây là khung chính.

      • processId

        số

        Không dùng nữa kể từ Chrome 50

        processId không còn được đặt cho sự kiện này nữa, vì quy trình sẽ hiển thị tài liệu kết quả không được biết cho đến khi onCommit.

        Giá trị -1.

      • tabId

        số

        Mã nhận dạng của thẻ sắp diễn ra thao tác điều hướng.

      • timeStamp

        số

        Thời điểm trình duyệt sắp bắt đầu thao tác điều hướng, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống.

      • url

        chuỗi

  • bộ lọc

    object không bắt buộc

    • Điều kiện mà URL đang được điều hướng đến phải đáp ứng.

onCommitted

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

Được kích hoạt khi một thao tác điều hướng được thực hiện. Tài liệu (và các tài nguyên mà tài liệu đó tham chiếu đến, chẳng hạn như hình ảnh và khung phụ) có thể vẫn đang tải xuống, nhưng ít nhất một phần của tài liệu đã được nhận từ máy chủ và trình duyệt đã quyết định chuyển sang tài liệu mới.

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

    (details: object) => void

    • chi tiết

      đối tượng

      • documentId

        chuỗi

        Chrome 106 trở lên

        UUID của tài liệu đã tải.

      • Chrome 106 trở lên

        Vòng đời của tài liệu.

      • frameId

        số

        0 cho biết thao tác điều hướng xảy ra trong cửa sổ nội dung thẻ; giá trị dương cho biết thao tác điều hướng trong khung phụ. Mã khung là duy nhất trong một thẻ.

      • Chrome 106 trở lên

        Loại khung mà thao tác di chuyển đã diễn ra.

      • parentDocumentId

        chuỗi không bắt buộc

        Chrome 106 trở lên

        UUID của tài liệu mẹ sở hữu khung này. Trường này không được đặt nếu không có phần tử mẹ.

      • parentFrameId

        số

        Chrome 74 trở lên

        Mã nhận dạng của khung mẹ hoặc -1 nếu đây là khung chính.

      • processId

        số

        Mã nhận dạng của quy trình chạy trình kết xuất cho khung này.

      • tabId

        số

        Mã nhận dạng của thẻ nơi diễn ra thao tác điều hướng.

      • timeStamp

        số

        Thời điểm thao tác điều hướng được thực hiện, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống.

      • transitionQualifiers

        TransitionQualifier[]

        Danh sách các bộ hạn định chuyển đổi.

      • transitionType

        TransitionType

        Nguyên nhân của thao tác điều hướng.

      • url

        chuỗi

  • bộ lọc

    object không bắt buộc

    • Điều kiện mà URL đang được điều hướng đến phải đáp ứng.

onCompleted

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

Được kích hoạt khi một tài liệu, bao gồm cả các tài nguyên mà tài liệu đó tham chiếu, được tải và khởi chạy hoàn toàn.

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

    (details: object) => void

    • chi tiết

      đối tượng

      • documentId

        chuỗi

        Chrome 106 trở lên

        UUID của tài liệu đã tải.

      • Chrome 106 trở lên

        Vòng đời của tài liệu.

      • frameId

        số

        0 cho biết thao tác điều hướng xảy ra trong cửa sổ nội dung thẻ; giá trị dương cho biết thao tác điều hướng trong khung phụ. Mã khung là duy nhất trong một thẻ.

      • Chrome 106 trở lên

        Loại khung mà thao tác di chuyển đã diễn ra.

      • parentDocumentId

        chuỗi không bắt buộc

        Chrome 106 trở lên

        UUID của tài liệu mẹ sở hữu khung này. Trường này không được đặt nếu không có phần tử mẹ.

      • parentFrameId

        số

        Chrome 74 trở lên

        Mã nhận dạng của khung mẹ hoặc -1 nếu đây là khung chính.

      • processId

        số

        Mã nhận dạng của quy trình chạy trình kết xuất cho khung này.

      • tabId

        số

        Mã nhận dạng của thẻ nơi diễn ra thao tác điều hướng.

      • timeStamp

        số

        Thời điểm tài liệu tải xong, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống.

      • url

        chuỗi

  • bộ lọc

    object không bắt buộc

    • Điều kiện mà URL đang được điều hướng đến phải đáp ứng.

onCreatedNavigationTarget

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

Được kích hoạt khi một cửa sổ mới hoặc một thẻ mới trong cửa sổ hiện có được tạo để lưu trữ một thành phần điều hướng.

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

    (details: object) => void

    • chi tiết

      đối tượng

      • sourceFrameId

        số

        Mã của khung có sourceTabId mà trong đó thao tác điều hướng được kích hoạt. 0 cho biết khung chính.

      • sourceProcessId

        số

        Mã của quy trình chạy trình kết xuất cho khung nguồn.

      • sourceTabId

        số

        Mã của thẻ kích hoạt thao tác điều hướng.

      • tabId

        số

        Mã của thẻ mà URL được mở

      • timeStamp

        số

        Thời điểm trình duyệt sắp tạo một chế độ xem mới, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống.

      • url

        chuỗi

        URL sẽ được mở trong cửa sổ mới.

  • bộ lọc

    object không bắt buộc

    • Điều kiện mà URL đang được điều hướng đến phải đáp ứng.

onDOMContentLoaded

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

Được kích hoạt khi DOM của trang được tạo hoàn chỉnh, nhưng các tài nguyên được tham chiếu có thể chưa tải xong.

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

    (details: object) => void

    • chi tiết

      đối tượng

      • documentId

        chuỗi

        Chrome 106 trở lên

        UUID của tài liệu đã tải.

      • Chrome 106 trở lên

        Vòng đời của tài liệu.

      • frameId

        số

        0 cho biết thao tác điều hướng xảy ra trong cửa sổ nội dung thẻ; giá trị dương cho biết thao tác điều hướng trong khung phụ. Mã khung là duy nhất trong một thẻ.

      • Chrome 106 trở lên

        Loại khung mà thao tác di chuyển đã diễn ra.

      • parentDocumentId

        chuỗi không bắt buộc

        Chrome 106 trở lên

        UUID của tài liệu mẹ sở hữu khung này. Trường này không được đặt nếu không có phần tử mẹ.

      • parentFrameId

        số

        Chrome 74 trở lên

        Mã nhận dạng của khung mẹ hoặc -1 nếu đây là khung chính.

      • processId

        số

        Mã nhận dạng của quy trình chạy trình kết xuất cho khung này.

      • tabId

        số

        Mã nhận dạng của thẻ nơi diễn ra thao tác điều hướng.

      • timeStamp

        số

        Thời điểm DOM của trang được tạo xong, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống.

      • url

        chuỗi

  • bộ lọc

    object không bắt buộc

    • Điều kiện mà URL đang được điều hướng đến phải đáp ứng.

onErrorOccurred

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

Được kích hoạt khi xảy ra lỗi và quá trình điều hướng bị huỷ. Điều này có thể xảy ra nếu xảy ra lỗi mạng hoặc người dùng huỷ thao tác điều hướng.

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

    (details: object) => void

    • chi tiết

      đối tượng

      • documentId

        chuỗi

        Chrome 106 trở lên

        UUID của tài liệu đã tải.

      • Chrome 106 trở lên

        Vòng đời của tài liệu.

      • error

        chuỗi

        Nội dung mô tả về lỗi.

      • frameId

        số

        0 cho biết thao tác điều hướng xảy ra trong cửa sổ nội dung thẻ; giá trị dương cho biết thao tác điều hướng trong khung phụ. Mã khung là duy nhất trong một thẻ.

      • Chrome 106 trở lên

        Loại khung mà thao tác di chuyển đã diễn ra.

      • parentDocumentId

        chuỗi không bắt buộc

        Chrome 106 trở lên

        UUID của tài liệu mẹ sở hữu khung này. Trường này không được đặt nếu không có phần tử mẹ.

      • parentFrameId

        số

        Chrome 74 trở lên

        Mã nhận dạng của khung mẹ hoặc -1 nếu đây là khung chính.

      • processId

        số

        Không dùng nữa kể từ Chrome 50

        processId không còn được đặt cho sự kiện này.

        Giá trị -1.

      • tabId

        số

        Mã nhận dạng của thẻ nơi diễn ra thao tác điều hướng.

      • timeStamp

        số

        Thời gian xảy ra lỗi, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống.

      • url

        chuỗi

  • bộ lọc

    object không bắt buộc

    • Điều kiện mà URL đang được điều hướng đến phải đáp ứng.

onHistoryStateUpdated

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

Được kích hoạt khi nhật ký của khung được cập nhật lên một URL mới. Tất cả sự kiện trong tương lai cho khung đó sẽ sử dụng URL mới.

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

    (details: object) => void

    • chi tiết

      đối tượng

      • documentId

        chuỗi

        Chrome 106 trở lên

        UUID của tài liệu đã tải.

      • Chrome 106 trở lên

        Vòng đời của tài liệu.

      • frameId

        số

        0 cho biết thao tác điều hướng xảy ra trong cửa sổ nội dung thẻ; giá trị dương cho biết thao tác điều hướng trong khung phụ. Mã khung là duy nhất trong một thẻ.

      • Chrome 106 trở lên

        Loại khung mà thao tác di chuyển đã diễn ra.

      • parentDocumentId

        chuỗi không bắt buộc

        Chrome 106 trở lên

        UUID của tài liệu mẹ sở hữu khung này. Trường này không được đặt nếu không có phần tử mẹ.

      • parentFrameId

        số

        Chrome 74 trở lên

        Mã nhận dạng của khung mẹ hoặc -1 nếu đây là khung chính.

      • processId

        số

        Mã nhận dạng của quy trình chạy trình kết xuất cho khung này.

      • tabId

        số

        Mã nhận dạng của thẻ nơi diễn ra thao tác điều hướng.

      • timeStamp

        số

        Thời điểm thao tác điều hướng được thực hiện, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống.

      • transitionQualifiers

        TransitionQualifier[]

        Danh sách các bộ hạn định chuyển đổi.

      • transitionType

        TransitionType

        Nguyên nhân của thao tác điều hướng.

      • url

        chuỗi

  • bộ lọc

    object không bắt buộc

    • Điều kiện mà URL đang được điều hướng đến phải đáp ứng.

onReferenceFragmentUpdated

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

Được kích hoạt khi mảnh tham chiếu của một khung hình được cập nhật. Tất cả sự kiện trong tương lai cho khung đó sẽ sử dụng URL mới.

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

    (details: object) => void

    • chi tiết

      đối tượng

      • documentId

        chuỗi

        Chrome 106 trở lên

        UUID của tài liệu đã tải.

      • Chrome 106 trở lên

        Vòng đời của tài liệu.

      • frameId

        số

        0 cho biết thao tác điều hướng xảy ra trong cửa sổ nội dung thẻ; giá trị dương cho biết thao tác điều hướng trong khung phụ. Mã khung là duy nhất trong một thẻ.

      • Chrome 106 trở lên

        Loại khung mà thao tác di chuyển đã diễn ra.

      • parentDocumentId

        chuỗi không bắt buộc

        Chrome 106 trở lên

        UUID của tài liệu mẹ sở hữu khung này. Trường này không được đặt nếu không có phần tử mẹ.

      • parentFrameId

        số

        Chrome 74 trở lên

        Mã nhận dạng của khung mẹ hoặc -1 nếu đây là khung chính.

      • processId

        số

        Mã nhận dạng của quy trình chạy trình kết xuất cho khung này.

      • tabId

        số

        Mã nhận dạng của thẻ nơi diễn ra thao tác điều hướng.

      • timeStamp

        số

        Thời điểm thao tác điều hướng được thực hiện, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống.

      • transitionQualifiers

        TransitionQualifier[]

        Danh sách các bộ hạn định chuyển đổi.

      • transitionType

        TransitionType

        Nguyên nhân của thao tác điều hướng.

      • url

        chuỗi

  • bộ lọc

    object không bắt buộc

    • Điều kiện mà URL đang được điều hướng đến phải đáp ứng.

onTabReplaced

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

Được kích hoạt khi nội dung của thẻ được thay thế bằng một thẻ khác (thường là thẻ đã được kết xuất trước đó).

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

    (details: object) => void

    • chi tiết

      đối tượng

      • replacedTabId

        số

        Mã của thẻ đã được thay thế.

      • tabId

        số

        Mã của thẻ thay thế thẻ cũ.

      • timeStamp

        số

        Thời điểm thay thế, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống.