Native messaging 可以让 extension 与安装在用户计算机上的原生应用交换信息。 原生应用仅需给 extension 提供服务，而无需在网页中可访问。 一个常见的例子是密码管理器: 原生应用负责存储和加密你的密码，并且和 extension 通信来填充网页中的表单字段。Native messaging 可以让 extension 拥有那些WebExtensions APIs 所没有的功能，比如访问某些特定的硬件。
原生应用的安装与管理并不是在浏览器当中的： 它应该是使用操作系统进行安装，和其他的原生应用一样。然后你需要将你的原生应用安装在指定位置，并提供一个清单。清单中描述了浏览器如何连接到你的原生应用。
extension 必须在 manifest.json 中获得"nativeMessaging" 权限。 同时，原生应用也需要在其清单中的 "allowed_extensions" 字段中包含 extension 的ID来表示允许该 extension 与自己进行通信。
经过上述操作，extension 就可以通过 {{WebExtAPIRef("runtime")}} API 与原生应用进行JSON数据通信了。原生应用可以通过标准输入/输出来接受/返回数据与 extension 通信。
和 Chrome 相比，WebExtensions 所支持的 native messaging 有2个主要区别：
Github 中的 webextensions-examples 仓库有一个完整的关于 native messaging 的例子，文章中的大部分代码片段均出于此。
如果你想让你的 extension 与原生应用进行通信，你需要：
这有一个 manifest.json 的例子:
{
"description": "Native messaging example extension",
"manifest_version": 2,
"name": "Native messaging example",
"version": "1.0",
"icons": {
"48": "icons/message.svg"
},
"applications": {
"gecko": {
"id": "ping_pong@example.org",
"strict_min_version": "50.0"
}
},
"background": {
"scripts": ["background.js"]
},
"browser_action": {
"default_icon": "icons/message.svg"
},
"permissions": ["nativeMessaging"]
}
原生应用清单描述了浏览器如何与原生应用进行连接。
原生应用清单需要与原生应用一起安装，浏览器仅会查阅清单而不会安装或管理原生应用。因此，何时采用何种方式来安装或更新这些文件的安全模型比起使用WebExtensions APIs 更像原生应用 。（我也搞不懂这句啥意思，原文：Thus the security model for when and how these files are installed and updated is much more like that for native applications than that for extensions using WebExtension APIs.）
关于原生应用清单的详细语法和路径规则，可参考 原生应用清单。
除清单外，原生应用还必需配置路径规则，你可以参考 原生应用清单 来配置路径。
这有一个例子，是关于 "ping_pong" 原生应用的清单：
{
"name": "ping_pong",
"description": "Example host for native messaging",
"path": "/path/to/native-messaging/app/ping_pong.py",
"type": "stdio",
"allowed_extensions": [ "ping_pong@example.org" ]
}
上面的清单代表：
对于Windows: 在上面的例子中，原生应用是一个Python脚本，它在Windows下可能是无法运行的。一个代替方案是提供一个 .bat 文件，并且在清单中指向这个 .bat 文件：
{
"name": "ping_pong",
"description": "Example host for native messaging",
"path": "c:\\path\\to\\native-messaging\\app\\ping_pong_win.bat",
"type": "stdio",
"allowed_extensions": [ "ping_pong@example.org" ]
}
在 .bat 文件中调用 Python 脚本：
@echo off python -u "c:\\path\\to\\native-messaging\\app\\ping_pong.py"
根据上面的配置，extension已经可以和原生应用交换JSON信息了。
你使用过 messaging APIs 与 content script 通信，与原生应用通信你应该非常熟悉，有2种方式：
在这种方式下，你需要调用 {{WebExtAPIRef("runtime.connectNative()")}} 并传入原生应用的名称（名称在原生应用清单中的 "name" 字段定义）。这个操作将会运行原生应用（如果它之前没在运行的话）并返回一个 {{WebExtAPIRef("runtime.Port")}} 。
当原生应用启动后，它被会传入2个参数：
原生应用会一直保持运行，直到 extension 调用 Port.disconnect() 或连接它的记录被结束。
使用 Port ，调用 postMessage() 传入一个JSON来发送消息，使用 onMessage.addListener() 来接收消息。
下面是一个例子：background script 建立与 ping_pong 原生应用的链接，并监听原生应用发来的消息。每当browser action 点击时，发送一个 ping 的消息给原生应用。
/*
启动，连接 ping_pong 原生应用
*/
var port = browser.runtime.connectNative("ping_pong");
/*
监听从原生应用发来的消息
*/
port.onMessage.addListener((response) => {
console.log("Received: " + response);
});
/*
每当 browser action 被点击时，发送一条消息给原生应用
*/
browser.browserAction.onClicked.addListener(() => {
console.log("Sending: ping");
port.postMessage("ping");
});
在这种模式下你需要调用 {{WebExtAPIRef("runtime.sendNativeMessage()")}} 传入如下参数：
每个消息都会创建一个新的原生应用实例。当原生应用启动时会被传入2个参数：
原生应用发送的第一条消息将会被作为对 sendNativeMessage() 响应，将会被传入回调函数中。
这有一个例子，对在上方的代码片段进行重写，改成使用 runtime.sendNativeMessage() 的方式：
function onResponse(response) {
console.log("Received " + response);
}
function onError(error) {
console.log(`Error: ${error}`);
}
/*
每当 browser action 被点击时，发送一条消息给原生应用
*/
browser.browserAction.onClicked.addListener(() => {
console.log("Sending: ping");
var sending = browser.runtime.sendNativeMessage(
"ping_pong",
"ping");
sending.then(onResponse, onError);
});
在原生应用端，使用标准输入来接受消息，使用标准输出来发送消息。
每条消息将会被序列化成UTF-8格式的JSON数据，并且在消息前面有一个32位的值来表示该条消息使用本地字节序的长度。
发送给原生应用的单条消息最大是1MB，总消息不得超越4GB。
下面是一个用 Python 写的原生应用例子。监听 extensions 发送的消息，如果消息是 ping，则回复 pong：
#!/usr/bin/python -u
# Note that running python with the `-u` flag is required on Windows,
# in order to ensure that stdin and stdout are opened in binary, rather
# than text, mode.
import sys, json, struct
# 从 stdin 读取解码消息
def getMessage():
rawLength = sys.stdin.read(4)
if len(rawLength) == 0:
sys.exit(0)
messageLength = struct.unpack('@I', rawLength)[0]
message = sys.stdin.read(messageLength)
return json.loads(message)
# 为了能被传输，对给定的内容进行编码
def encodeMessage(messageContent):
encodedContent = json.dumps(messageContent)
encodedLength = struct.pack('@I', len(encodedContent))
return {'length': encodedLength, 'content': encodedContent}
# 向 stdout 发送一个已编码的消息
def sendMessage(encodedMessage):
sys.stdout.write(encodedMessage['length'])
sys.stdout.write(encodedMessage['content'])
sys.stdout.flush()
while True:
receivedMessage = getMessage()
if (receivedMessage == "ping"):
sendMessage(encodeMessage("pong"))
如果你通过 runtime.connectNative() 连接原生应用，则原生应用会一直保持运行，直到 extension 调用 Port.disconnect() 或连接它的记录被结束。 如果你通过 runtime.sendNativeMessage() 向原生应用发消息，原生应用会在回复消息后被关闭。
关闭原生应用的过程：
CREATE_BREAKAWAY_FROM_JOB 标记。如果有什么地方出错，可以检查浏览器控制台。原生应用发送的任何 stderr 都会被反应在浏览器控制台中。所以如果你已经运行了原生应用，你可以看到原生应用发出的所有错误信息。
如果你没有配置好原生应用，你应该会看到一些错误信息。
"No such native application <name>"
runtime.connectNative() 传入的名称与应用程序清单中的名称一致"Error: Invalid application <name>"
"'python' is not recognized as an internal or external command, ..."
"File at path <path> does not exist, or is not executable"
"This extension does not have permission to use native application <name>"
"TypeError: browser.runtime.connectNative is not a function"
"[object Object] NativeMessaging.jsm:218"
{{Page("Mozilla/Add-ons/WebExtensions/Chrome_incompatibilities", "Native_messaging")}}