Fired when a connection is made with either an extension process or a content script.
browser.runtime.onConnect.addListener(listener)
浏览器
.
runtime
.
onConnect
.
removeListener
(
listener
)
浏览器
.
runtime
.
onConnect
.
hasListener
(
listener
)
Events have three functions:
addListener(callback)
Adds a listener to this event.
removeListener(listener)
Stop listening to this event. The
listener
argument is the listener to remove.
hasListener(listener)
Checks whether a
listener
is registered for this event. Returns
true
if it is listening,
false
否则。
function
A callback function that will be called when this event occurs. The function will be passed the following arguments:
port
A
runtime.Port
object connecting the current script to the other context it is connecting to.
BCD tables only load in the browser
This content script:
Port
in a variable
myPort
myPort
, and logs them
myPort
, when the user clicks the document
// content-script.js
var myPort = browser.runtime.connect({name:"port-from-cs"});
myPort.postMessage({greeting: "hello from content script"});
myPort.onMessage.addListener(function(m) {
console.log("In content script, received message from background script: ");
console.log(m.greeting);
});
document.body.addEventListener("click", function() {
myPort.postMessage({greeting: "they clicked the page!"});
});
The corresponding background script:
portFromCS
portFromCS
, when the user clicks the extension's browser action
// background-script.js
var portFromCS;
function connected(p) {
portFromCS = p;
portFromCS.postMessage({greeting: "hi there content script!"});
portFromCS.onMessage.addListener(function(m) {
console.log("In background script, received message from content script")
console.log(m.greeting);
});
}
browser.runtime.onConnect.addListener(connected);
browser.browserAction.onClicked.addListener(function() {
portFromCS.postMessage({greeting: "they clicked the button!"});
});
注意：
This API is based on Chromium's
chrome.runtime
API. This documentation is derived from
runtime.json
in the Chromium code.
Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.
最后修改： , 由 MDN 贡献者