Questa traduzione è incompleta. Collabora alla traduzione di questo articolo dall’originale in lingua inglese.

Connette l'estensione ad un'applicazione nativa presente sul computer dell'utente.
 
Utilizza il nome di un'applicazione nativa come parametro.
Avvia l'applicazione nativa e restituisce un oggetto runtime.Port alla funzione invocante.
 
La funzione invocante può usare la Port per scambiare messaggi con l'applicazione nativa utilizzando Port.postMessage() e port.onMessage.
 
L'applicazione nativa rimane attiva a meno che non termini autonomamente, sia invocata la funzione Port.disconnect(), o la pagina che ha generato la Port venga distrutta. Un volta disconnessa la Port il browser rimane in attesa qualche secondo finchè il processo non termina correttamente ed in definitiva lo chiude se non fosse ancora terminato.
Per maggiori informazioni, vedere Native messaging.

Syntax

var port = browser.runtime.connectNative(
  application // string
)

Parameters

application
string. Il nome dell'applicazione nativa alla quale collegarsi. Questo deve combaciare con la proprietà "name" nel native application's manifest file.

Return value

Un oggetto runtime.Port. La porta che la funzione invocante può usare per scambiare messaggi con l'applicazione nativa.

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxOperaFirefox for Android
Basic supportChrome Full support 29Edge Full support 15Firefox Full support 50Opera Full support 16Firefox Android No support No

Legend

Full support  
Full support
No support  
No support

Examples

L'esempio crea una connessione con l'applicazione nativa "ping_pong" e rimane in ascolto per i messaggi in entrata. Invia inoltre, all'applicazione nativa, un messaggio nel momento in cui l'utente clicca su un'icona specifica del browser:

/*
On startup, connect to the "ping_pong" app.
*/
var port = browser.runtime.connectNative("ping_pong");

/*
Listen for messages from the app.
*/
port.onMessage.addListener((response) => {
  console.log("Received: " + response);
});

/*
On a click on the browser action, send the app a message.
*/
browser.browserAction.onClicked.addListener(() => {
  console.log("Sending:  ping");
  port.postMessage("ping");
});

Example extensions

Fonti informative

Questa API è basata sull'API Chromium chrome.runtime.  Questo documento deriva dal runtime.json del codice di Chromium.

La compatibilità con Microsoft Edge è fornita da Microsoft ed è qui inclusa su licenza Creative Commons Attribution 3.0 United States License.

Tag del documento e collaboratori

Hanno collaborato alla realizzazione di questa pagina: mxggithub
Ultima modifica di: mxggithub,