Web ページがバックグラウンド ページの関数を呼び出す前に、次の問題を解決する必要があります。
hello();
Webページから利用できること。これは、コンテンツ スクリプトを使用して定義するスクリプトを挿入することによって行われます。hello
挿入された関数は、カスタム イベントまたは を使用してコンテンツ スクリプトと通信しますpostMessage
。
- コンテンツ スクリプトは、バックグラウンドと通信する必要があります。これは を通じて実装されます
chrome.runtime.sendMessage
。
Web ページも応答を受信する必要がある場合:
sendMessage
バックグラウンド ページ ( / onMessage
、以下を参照)から返信を送信します。
- コンテンツ スクリプトで、カスタム イベントを作成するか
postMessage
、Web ページにメッセージを送信するために使用します。
- Web ページで、このメッセージを処理します。
これらのメソッドはすべて非同期であり、コールバック関数を介して実装する必要があります。
これらの手順は慎重に設計する必要があります。上記のすべての手順を実装する一般的な実装を次に示します。実装について知っておくべきこと:
- 挿入されるコードでは
sendMessage
、コンテンツ スクリプトに接続する必要があるときはいつでもメソッドを使用します。
使用法:sendMessage(<mixed message> [, <function callback>])
contentscript.js
// Random unique name, to be used to minimize conflicts:
var EVENT_FROM_PAGE = '__rw_chrome_ext_' + new Date().getTime();
var EVENT_REPLY = '__rw_chrome_ext_reply_' + new Date().getTime();
var s = document.createElement('script');
s.textContent = '(' + function(send_event_name, reply_event_name) {
// NOTE: This function is serialized and runs in the page's context
// Begin of the page's functionality
window.hello = function(string) {
sendMessage({
type: 'sayhello',
data: string
}, function(response) {
alert('Background said: ' + response);
});
};
// End of your logic, begin of messaging implementation:
function sendMessage(message, callback) {
var transporter = document.createElement('dummy');
// Handles reply:
transporter.addEventListener(reply_event_name, function(event) {
var result = this.getAttribute('result');
if (this.parentNode) this.parentNode.removeChild(this);
// After having cleaned up, send callback if needed:
if (typeof callback == 'function') {
result = JSON.parse(result);
callback(result);
}
});
// Functionality to notify content script
var event = document.createEvent('Events');
event.initEvent(send_event_name, true, false);
transporter.setAttribute('data', JSON.stringify(message));
(document.body||document.documentElement).appendChild(transporter);
transporter.dispatchEvent(event);
}
} + ')(' + JSON.stringify(/*string*/EVENT_FROM_PAGE) + ', ' +
JSON.stringify(/*string*/EVENT_REPLY) + ');';
document.documentElement.appendChild(s);
s.parentNode.removeChild(s);
// Handle messages from/to page:
document.addEventListener(EVENT_FROM_PAGE, function(e) {
var transporter = e.target;
if (transporter) {
var request = JSON.parse(transporter.getAttribute('data'));
// Example of handling: Send message to background and await reply
chrome.runtime.sendMessage({
type: 'page',
request: request
}, function(data) {
// Received message from background, pass to page
var event = document.createEvent('Events');
event.initEvent(EVENT_REPLY, false, false);
transporter.setAttribute('result', JSON.stringify(data));
transporter.dispatchEvent(event);
});
}
});
background.js
chrome.runtime.onMessage.addListener(function(message, sender, sendResponse) {
if (message && message.type == 'page') {
var page_message = message.message;
// Simple example: Get data from extension's local storage
var result = localStorage.getItem('whatever');
// Reply result to content script
sendResponse(result);
}
});
Chrome 拡張機能はマニフェスト ファイルなしでは完全ではないためmanifest.json
、回答をテストするために使用したファイルを次に示します。
{
"name": "Page to background and back again",
"version": "1",
"manifest_version": 2,
"background": {
"scripts": ["background.js"]
},
"content_scripts": [{
"matches": ["http://jsfiddle.net/jRaPj/show/*"],
"js": ["contentscript.js"],
"all_frames": true,
"run_at": "document_start"
}]
}
この拡張機能は、http://jsfiddle.net/jRaPj/show/ (hello();
質問に表示されている内容を含む) でテストされ、「Background said: null」というダイアログが表示されます。
バックグラウンド ページを開き、 を使用localStorage.setItem('whatever', 'Hello!');
して、メッセージが正しく変更されていることを確認します。