2. 程式人生 > >【Chrome】如何在C++中增加給JavaScript呼叫的API

【Chrome】如何在C++中增加給JavaScript呼叫的API

阿新 • • 發佈：2019-01-31

本文示例說明了如何在Chrome瀏覽器中增加JavaScript API。為了簡化，先假設是在已有的namespace中增加一個新的API，文章的最後將指出如果增加一下全新的namespace所需注意的事項。

在繼續之前，請確保你的Chrome瀏覽器中已安裝了一些擴充套件程式。可以在位址列中輸入chrome://extensions檢視已安裝的擴充套件程式。下圖示例說明了我的瀏覽器中已安裝了Google Mail Checker擴充套件程式，我們將使用它來測試新增的API（測試可以使用任何擴充套件程式，而不需指定這所示例的Google Mail checker）。

從上圖也同時示例瞭如何開啟Chrome網上商店，我們需要進入該頁面檢視已開發好的API。進入頁面後按F12開啟開發者工具，並將開發者工具切換到控制檯。

在開發者工具的控制檯中，輸入“chrome.management.un”其將顯示management namespace所支援的API。

下面我們要做的，就是在management中增加showButton API，用於顯示或隱藏擴充套件欄上（某）擴充套件程式的Icon。增加showButton API大體上分成兩大部驟。步驟一為變更C++程式碼，步驟二為變更management.json介面描述檔案。下面逐步講解基於Chrome R28原始碼的具體變更內容。

首先，在src\chrome\browser\extensions\api\management\management_api.h中增加一個新類的宣告。當showButton在Javascript中被呼叫時，該類將負責進行後續處理，其RunImpl方法將會被呼叫。

1 2 3 4 5 6 class ManagementShowButtonFunction : public ManagementFunction { public: DECLARE_EXTENSION_FUNCTION("management.showButton", MANAGEMENT_UNINSTALL) private: virtual bool RunImpl() OVERRIDE; };

接著，在src\chrome\browser\extensions\api\management\management_api.cc中增加新類的實現。RunImpl方法根據JavaScript所傳入的兩個引數呼叫SetBrowserActionVisibility函式，實現對擴充套件程式Icon的顯示和隱藏。第一個引數為擴充套件程式的ID，第二個引數是一個布林變數，用於指示是顯示（true）抑或隱藏（false）擴充套件程式的Icon。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 bool ManagementShowButtonFunction::RunImpl() { std::string extension_id; EXTENSION_FUNCTION_VALIDATE(args_->GetString(0, &extension_id)); bool enable; EXTENSION_FUNCTION_VALIDATE(args_->GetBoolean(1, &enable)); const Extension* extension = service()->GetExtensionById(extension_id, true); if (!extension) { error_ = ErrorUtils::FormatErrorMessage( keys::kNoExtensionError, extension_id); return false; } service()->extension_prefs()->SetBrowserActionVisibility(extension, enable); return true; }

最後，我們在src\chrome\common\api\management.json中增加showButton的描述。請注意，在該檔案中存在functoins和events兩大部分，一定要將新增內容放入functions部分。為了防止變更JSON檔案時出錯，可以使用Notepad++，並在其上安裝JSLint和JSMin兩個外掛。在編輯完JSON檔案後先呼叫Plugins->JSMin->JSFormat（Notepad++中的選單命令），然後是Plugins->JSLint->JSLint Current File檢查是否存在錯誤。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 { "name" : "showButton", "description" : "Show/Hide extension icon on extension bar.", "parameters" : [ { "name" : "id", "type" : "string", "description" : "This should be the id from an item of $ref:ExtensionInfo." }, { "name" : "enabled", "type" : "boolean", "description" : "Whether this item should be enabled or disabled." } ] }

有了以上的變更後，在編譯Chrome專案之前，需手動重新編譯api專案，因為Chrome專案並不依賴於api專案。重新編譯將使得在自動生成的GeneratedFunctionRegistry:: RegisterAll函式內增加對ManagementShowButtonFunction的註冊。

程式編譯完成後，我們可以在開發者工具的控制檯上測試showButton函式。下圖示例說明了通過呼叫該函式隱藏和顯示Google Mail Checker擴充套件程式的Icon。

上面示例瞭如何在已存在的management namespace中增加一個API。在Chrome中，JavaScript API的使用存在許可權的概念。如果新增API的同時也需新增namespace的話，需要注意在APIPermissionInfo::RegisterAllPermissions方法中註冊新增namespace的許可權，否則會出現頁面無法訪問新增API的問題。

相關推薦

【Chrome】如何在C++中增加給JavaScript呼叫的API

本文示例說明了如何在Chrome瀏覽器中增加JavaScript API。為了簡化，先假設是在已有的namespace中增加一個新的API，文章的最後將指出如果增加一下全新的namespace所需注意的事項。 在繼續之前，請確保你的Chrome瀏覽器中已安裝了一些擴充

【轉】C#中的兩把雙刃劍：抽象類和接口

實例 可維護 對象 為什麽不使用 程序 一定的 代碼 方式 索引 轉：http://www.cnblogs.com/djzxjblogs/p/7587735.html 第一次面試的時候， 面試官問我，抽象類和接口的區別。 本人也是，按照面試寶典上的回答，說了一大堆。

【轉】C++中const在函數名前面和函數後面的區別

const成員函數 調用 參數傳遞 成員 指向 int 區別 ... urn 一、概念 　　當const在函數名前面的時候修飾的是函數返回值，在函數名後面表示是常成員函數，該函數不能修改對象內的任何成員，只能發生讀操作，不能發生寫操作。 二、原理： 　　我們都知道在調用

【整理】C++中的unique函數

函數 數字 元素 vector 整理 rds 總結 改變 new 之前總結了一下我覺得有用的erase，lower_bound,upper_bound。 現在總結一下unique，unique的作用是“去掉”容器中相鄰元素的重復元素（不一定要求

【雜記】C#中的回車換行符

語言 color 雜記 pan blog == 一行 div 屬性 在 C# 中，我們用字符串 "\r\n" 表示回車換行符。 如： string str = "第一行\r\n第二行"; 但是我們更推薦 Environment.NewLine（名稱空間為 System）

【轉載】C++中的模板template <typename T>

最新 bsp 針對 www. code mark 方法 固定格式 應該 從一位大佬的程序中看到的，好像挺牛的！！ 這個是C++中的模板..template<typename T> 這個是定義模板的固定格式,規定了的..模板應該可以理解到它的意思吧.. 比如你想求

【轉載】 c++中static的用法詳解

ostream 並不會 style 轉載 程序員 都是 note 每次 reference 出處： http://blog.csdn.net/majianfei1023/article/details/45290467 C 語言的 static 關鍵字有三種（具體來說是

AppDomain 詳解二【轉】-C#中動態加載和卸載DLL

all created 新版本 odin generic reflect 可能 params 詳細 在C++中加載和卸載DLL是一件很容易的事，LoadLibrary和FreeLibrary讓你能夠輕易的在程序中加載DLL，然後在任何地方 卸載。在C#中我們也能使用Asse

【轉】C#中Func與Action的理解

.net ring UNC 簡單 代碼 操作 不必要 返回值 tps 原文地址：https://www.cnblogs.com/ultimateWorld/p/5608122.html Action 與 Func是.NET類庫中增加的內置委托，以便更加簡潔方便的使用委托。最

【轉】C#中的combobox裏DropDownStyle

csdn https 選項 lis 編輯 mbo art rop tails 源地址：https://blog.csdn.net/cf643487053/article/details/54016822 C#中的combobox控件裏DropDownStyle有三種選項 S

【轉載】c++中的this指標

原連結：https://blog.csdn.net/u012372584/article/details/39032361?utm_source=blogxgwz1 原連結上的內容較亂，特意整理了一下 this指標         在建立物件時，系

【轉】c++中的static關鍵字總結

個人總結： static會隱藏全域性變數和全域性函式可見範圍，使其盡在定義檔案中可見； static會改變區域性變數生存週期，在程式中一直存在，而不僅僅在區域性變數定義的函式中； static會改變類的成員變數的生存週期，在程式中一直存在； static會修改函式的使用方

【perl】數字中增加逗號

#!/usr/bin/perl use strict; use warnings; my $num = 1234556789; #純資料模式 $num =~ s/(?<=\d)(?=(\d{3})+$)/,/g; #零寬斷言,(?=exp)匹配exp前面的位置 print $num,"\n"

【轉載】C#中out和ref之間的區別

首先：兩者都是按地址傳遞的，使用後都將改變原來引數的數值。 其次：ref可以把引數的數值傳遞進函式，但是out是要把引數清空，就是說你無法把一個數值從out傳遞進去的，out進去後，引數的數值為空，所以你必須初始化一次。這個就是兩個的區別，或者說就像有的網友說的，ref是有進有出，out是隻出不進。

【轉】C++中堆和棧的理解

一、預備知識—程式的記憶體分配 一個由c/C++編譯的程式佔用的記憶體分為以下幾個部分 1、棧區（stack）— 由編譯器自動分配釋放 ，存放函式的引數值，區域性變數的值等。其操作方式類似於資料結構中的棧。 2、堆區（heap） — 一般由程式設計師分配釋放， 若程式設計

【轉載】C++中priority_queue的用法

1、標頭檔案 #include<queue> 2、普通定義方法 priority_queue<int> p; 3、更一般的定義方法 priority_queue<Type, Container, Functional&

【轉載】C# 中的委託和事件(詳解：簡單易懂的講解) C# 中的委託和事件(詳解)

本文轉載自http://www.cnblogs.com/SkySoot/archive/2012/04/05/2433639.html C# 中的委託和事件(詳解) C# 中的委託和事件

【原】SVN中如何給專案打基線

    打基線就是給被打基線的東西加一個標識，然後在這些東西已經有了變化形成了新的版本後，還能看到打基線的時候這些東西的原來的樣子，從而可以對其進行追蹤和版本隔離。 在專案管理中，打基線主要是在專案進入另一個階段時把上一階段的東西打個標識，從而也作為下一階段的開始。    

【筆記】C++中一些易混淆的知識點

Note 文章的知識點基本來自於《C++ Primer》，其中的觀點可以看作是對原文的翻譯 Public，Protected，Private三種繼承方式 派生類在繼承列表中通過在基類名字前加上許可權標籤來確定繼承方式。 class Derived

【轉】C++中static用法總結

地址：https://www.cnblogs.com/qiaoconglovelife/p/5323086.html 1.用於區域性變數 C++中區域性變數有三種： （1）auto：此關鍵詞常常省略。auto type a 常常簡寫為type a。 如：int a=auto int