Nội dung mô tả
API chrome.debugger
đóng vai trò là mạng truyền tải thay thế cho giao thức gỡ lỗi từ xa của Chrome. Sử dụng chrome.debugger
để đính kèm vào một hoặc nhiều thẻ để đo lường tương tác mạng, gỡ lỗi JavaScript, thay đổi DOM và CSS, v.v. Sử dụng thuộc tính Debuggee
tabId
để nhắm mục tiêu các thẻ bằng sendCommand
và định tuyến sự kiện theo tabId
từ lệnh gọi lại onEvent
.
Quyền
debugger
Lưu ý bảo mật
Vì lý do bảo mật, API chrome.debugger
không cung cấp quyền truy cập vào tất cả Miền giao thức của Công cụ của Chrome cho nhà phát triển. Các miền hiện có là: Accessibility,
Testings, CacheStorage, Console,
CSS, Database, Trình gỡ lỗi, DOM, DOMDebugger, DOMSnapshotWebAudioWebAuthn
Tệp kê khai
Bạn phải khai báo quyền "debugger"
` trong tệp kê khai của tiện ích để sử dụng API này.
{
"name": "My extension",
...
"permissions": [
"debugger",
],
...
}
Ví dụ
Để dùng thử API này, hãy cài đặt ví dụ về API trình gỡ lỗi trong kho lưu trữ chrome-extension-samples.
Loại
Debuggee
Giá trị nhận dạng trình gỡ lỗi. Bạn phải chỉ định mã thẻ, mã tiện ích hoặc mã mục tiêu
Thuộc tính
-
extensionId
chuỗi không bắt buộc
Mã của tiện ích mà bạn định gỡ lỗi. Bạn chỉ có thể đính kèm vào trang nền của tiện ích khi sử dụng nút chuyển dòng lệnh
--silent-debugger-extension-api
. -
tabId
số không bắt buộc
Mã của thẻ mà bạn định gỡ lỗi.
-
targetId
chuỗi không bắt buộc
Mã không rõ ràng của mục tiêu gỡ lỗi.
DebuggerSession
Giá trị nhận dạng phiên của trình gỡ lỗi. Phải chỉ định một trong số tabId, extensionsId hoặc targetId. Ngoài ra, bạn có thể cung cấp sessionId (mã phiên hoạt động) không bắt buộc. Nếu sessionId được chỉ định cho các đối số được gửi từ onEvent
, thì tức là sự kiện này đến từ một phiên giao thức con trong phiên gỡ lỗi gốc. Nếu sessionId được chỉ định khi chuyển đến sendCommand
, thì mã này sẽ nhắm đến một phiên giao thức con trong phiên gỡ lỗi gốc.
Thuộc tính
-
extensionId
chuỗi không bắt buộc
Mã của tiện ích mà bạn định gỡ lỗi. Bạn chỉ có thể đính kèm vào trang nền của tiện ích khi sử dụng nút chuyển dòng lệnh
--silent-debugger-extension-api
. -
sessionId
chuỗi không bắt buộc
Mã không rõ ràng của phiên Giao thức Công cụ của Chrome cho nhà phát triển. Xác định phiên con trong phiên gốc được xác định bằng tabId, ExtensionId hoặc targetId.
-
tabId
số không bắt buộc
Mã của thẻ mà bạn định gỡ lỗi.
-
targetId
chuỗi không bắt buộc
Mã không rõ ràng của mục tiêu gỡ lỗi.
DetachReason
Lý do chấm dứt kết nối.
Liệt kê
"target_closed"
"canceled_by_user"
TargetInfo
Thông tin về mục tiêu gỡ lỗi
Thuộc tính
-
đã đính kèm
boolean
Đúng nếu trình gỡ lỗi đã được đính kèm.
-
extensionId
chuỗi không bắt buộc
Mã tiện ích, được xác định nếu loại = 'background_page'.
-
faviconUrl
chuỗi không bắt buộc
URL biểu tượng trang web mục tiêu.
-
id
string
Mã mục tiêu.
-
tabId
số không bắt buộc
Mã thẻ, được xác định nếu loại == 'page'.
-
title
string
Tiêu đề trang đích.
-
loại
Loại mục tiêu.
-
url
string
URL mục tiêu.
TargetInfoType
Loại mục tiêu.
Liệt kê
"background_page"
"worker"
"other"
Phương thức
attach()
chrome.debugger.attach(
target: Debuggee,
requiredVersion: string,
callback?: function,
)
Đính kèm trình gỡ lỗi vào mục tiêu nhất định.
Tham số
-
mục tiêu
Gỡ lỗi đích mà bạn muốn đính kèm.
-
requiredVersion
string
Phiên bản giao thức gỡ lỗi bắt buộc ("0.1"). Một ứng dụng chỉ có thể đính kèm vào ứng dụng gỡ lỗi có phiên bản lớn trùng khớp và phiên bản nhỏ hơn hoặc bằng. Bạn có thể lấy danh sách phiên bản giao thức tại đây.
-
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:() => void
Giá trị trả về
-
Promise<void>
Chrome 96 trở lênLờ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.
detach()
chrome.debugger.detach(
target: Debuggee,
callback?: function,
)
Tách trình gỡ lỗi khỏi mục tiêu đã cho.
Tham số
-
mục tiêu
Gỡ lỗi mục tiêu mà bạn muốn tách ra.
-
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:() => void
Giá trị trả về
-
Promise<void>
Chrome 96 trở lênLờ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.
getTargets()
chrome.debugger.getTargets(
callback?: function,
)
Trả về danh sách các mục tiêu gỡ lỗi có sẵn.
Tham số
-
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:(result: TargetInfo[]) => void
-
kết quả
Mảng gồm các đối tượng TargetInfo tương ứng với các mục tiêu gỡ lỗi có sẵn.
-
Giá trị trả về
-
Promise<TargetInfo[]>
Chrome 96 trở lênLờ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.
sendCommand()
chrome.debugger.sendCommand(
target: DebuggerSession,
method: string,
commandParams?: object,
callback?: function,
)
Gửi lệnh đã cho đến mục tiêu gỡ lỗi.
Tham số
-
mục tiêu
Gỡ lỗi đích mà bạn muốn gửi lệnh đến.
-
method
string
Tên phương thức. Phải là một trong các phương thức được xác định bằng giao thức gỡ lỗi từ xa.
-
commandParams
đối tượng không bắt buộc
Đối tượng JSON có tham số yêu cầu. Đối tượng này phải tuân thủ lược đồ thông số gỡ lỗi từ xa cho phương thức nhất định.
-
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:(result?: object) => void
-
kết quả
đối tượng không bắt buộc
Đối tượng JSON có phản hồi. Cấu trúc của phản hồi thay đổi tuỳ theo tên phương thức và được xác định bằng thuộc tính "returns" của phần mô tả lệnh trong giao thức gỡ lỗi từ xa.
-
Giá trị trả về
-
Promise<object | undefined>
Chrome 96 trở lênLờ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
onDetach
chrome.debugger.onDetach.addListener(
callback: function,
)
Được kích hoạt khi trình duyệt chấm dứt phiên gỡ lỗi cho thẻ. Điều này xảy ra khi thẻ đang đóng hoặc Công cụ của Chrome cho nhà phát triển đang được gọi cho thẻ đính kèm.
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(source: Debuggee, reason: DetachReason) => void
-
nguồn
-
lý do
-
onEvent
chrome.debugger.onEvent.addListener(
callback: function,
)
Được kích hoạt bất cứ khi nào sự kiện đo lường vấn đề về mục tiêu gỡ lỗi.
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(source: DebuggerSession, method: string, params?: object) => void
-
nguồn
-
method
string
-
params
đối tượng không bắt buộc
-