国产av日韩一区二区三区精品,成人性爱视频在线观看,国产,欧美,日韩,一区,www.成色av久久成人,2222eeee成人天堂

首頁 web前端 js教程 Chrome 擴(kuò)展程序 - 實現(xiàn)擴(kuò)展程序

Chrome 擴(kuò)展程序 - 實現(xiàn)擴(kuò)展程序

Jan 06, 2025 pm 10:32 PM

在上一篇文章中,我向您展示了如何設(shè)置 Chromium 擴(kuò)展項目,因此它支持 TypeScript、盡可能的自動完成功能,并且作為入門工具可以很好地工作?,F(xiàn)在,我將簡要展示我的簡單頁面音頻擴(kuò)展的實現(xiàn)。

簡介

主意

Chrome extension  - implementing an extension

我對擴(kuò)展的要求非常簡單 - 當(dāng)我訪問特定網(wǎng)站時,它應(yīng)該開始播放預(yù)定義的音頻。硬編碼的網(wǎng)站名稱和音頻完全沒問題。

更詳細(xì)地說,當(dāng)我打開 www.example.com 時,音頻應(yīng)該開始播放,當(dāng)我切換到不同的選項卡時停止,當(dāng)我返回 www.example.com 時繼續(xù)播放。另外,如果我有兩個(或更多)打開 www.example.com 的選項卡并且我在它們之間切換,則音頻應(yīng)該繼續(xù)播放而無需重新啟動。換句話說,音頻應(yīng)該在整個擴(kuò)展級別播放,而不是單個選項卡。

通用技術(shù)方法

簡而言之,我們需要在某處創(chuàng)建 HTMLAudioElement 并根據(jù)當(dāng)前選項卡中的網(wǎng)站播放/暫停它。

它可以通過 Service Worker 和內(nèi)容腳本實現(xiàn) - 我們可以使用一個內(nèi)容腳本在每個頁面上創(chuàng)建一個 HTMLAudioElement 元素,并使用 Service Worker 來協(xié)調(diào)播放。當(dāng)選項卡失去焦點時,它會將當(dāng)前媒體時間范圍傳遞給 Service Worker,當(dāng)具有匹配 URL 的另一個選項卡獲得焦點時,它會向 Service Worker 詢問時間范圍并從那里恢復(fù)播放。

但是,我認(rèn)為這種方法有點復(fù)雜,并且可能容易出錯。如果我們可以只有一個 HTMLAudioElement 元素并全局播放/暫停它,而不是從單個選項卡播放/暫停,那就更好了。幸運的是,有一個有趣的 API 可以為我們提供很大幫助——offscreen API。

Offscreen API 允許擴(kuò)展程序創(chuàng)建一個不可見的 HTML 文檔。使用它,我們將有一個地方來保存 HTMLAudioElement 并在需要時播放/暫停它。請記住,Service Worker 仍然無法執(zhí)行任何 DOM 操作,因此我們需要在屏幕外文檔上添加一些輔助腳本來接收 Service Worker 消息并充分控制播放器。

執(zhí)行

Chrome extension  - implementing an extension

在manifest.json中需要權(quán)限

我的擴(kuò)展需要權(quán)限數(shù)組中的兩個條目:

  • 選項卡 - 它需要知道用戶何時切換和/或更新選項卡
  • 離屏 - 它需要能夠創(chuàng)建離屏文檔才能從那里播放音頻

如果您在瀏覽器中打開擴(kuò)展程序詳細(xì)信息,您將看到如下所示的權(quán)限:

閱讀您的瀏覽歷史記錄

它可能看起來有點可怕,但這就是添加選項卡權(quán)限的原因。不幸的是,我無法找到一種與權(quán)限無關(guān)的不??同方法。我的其他想法導(dǎo)致了更可怕的權(quán)限集?在此線程中,您可以閱讀為什么選項卡權(quán)限會導(dǎo)致該條目。

管理屏外文檔

正如我所提到的,我只想擁有一個 HTMLAudioElement 并從中播放音頻。為了使其獨立于選項卡,我將使用離屏 API 創(chuàng)建一個文檔,該文檔將由來自 Service Worker 的消息保存和控制。

我喜歡面向?qū)ο缶幊?,所以這里有 OffscreenDoc 類幫助進(jìn)行離屏文檔管理。本質(zhì)上,它只是創(chuàng)建屏幕外文檔(如果尚未創(chuàng)建)。

// ts/offscreen-doc.ts
/**
 * Static class to manage the offscreen document
 */
export class OffscreenDoc {
    private static isCreating: Promise<boolean | void> | null;
    private constructor() {
        // private constructor to prevent instantiation
    }

    /**
     * Sets up the offscreen document if it doesn't exist
     * @param path - path to the offscreen document
     */
    static async setup(path: string) {
        if (!(await this.isDocumentCreated(path))) {
            await this.createOffscreenDocument(path);
        }
    }

    private static async createOffscreenDocument(path: string) {
        if (OffscreenDoc.isCreating) {
            await OffscreenDoc.isCreating;
        } else {
            OffscreenDoc.isCreating = chrome.offscreen.createDocument({
                url: path,
                reasons: ['AUDIO_PLAYBACK'],
                justification:
                    'Used to play audio independently from the opened tabs',
            });
            await OffscreenDoc.isCreating;
            OffscreenDoc.isCreating = null;
        }
    }

    private static async isDocumentCreated(path: string) {
        // Check all windows controlled by the service worker to see if one
        // of them is the offscreen document with the given path
        const offscreenUrl = chrome.runtime.getURL(path);
        const existingContexts = await chrome.runtime.getContexts({
            contextTypes: ['OFFSCREEN_DOCUMENT'],
            documentUrls: [offscreenUrl],
        });
        return existingContexts.length > 0;
    }
}

如您所見,唯一的公共方法是 setup ,調(diào)用時需要一些路徑。這是 HTML 文檔模板的路徑,該模板將用于創(chuàng)建我們的屏幕外文檔。在我們的例子中,這將非常簡單:

<!-- offscreen.html -->
<script src="dist/offscreen.js" type="module"></script>

從字面上看,只是一個腳本標(biāo)簽。該腳本將用于接收 Service Worker 消息、創(chuàng)建 HTMLAudioElement 以及播放/暫停音樂。它還有 type="module",因為我將在那里導(dǎo)入一些東西。

但是要接收消息,我們可能應(yīng)該先發(fā)送它們。

消息接口

消息沒有任何嚴(yán)格的接口。我們只需要確保它們是 JSON 可序列化的。但是,我希望盡可能類型安全,因此我為擴(kuò)展中傳遞的消息定義了一個簡單的接口:

// ts/audio-message.ts
export interface AudioMessage {
    /**
     * Command to be executed on the audio element.
     */
    command: 'play' | 'pause';
    /**
     * Source of the audio file.
     */
    source?: string;
}

稍后您就會發(fā)現(xiàn) sendMessage 方法不太適合打字,但有一個簡單的解決方法仍然可以從類型安全中受益。

從 Service Worker 發(fā)送消息

Service Worker 是我們擴(kuò)展的“大腦”,知道發(fā)生了什么以及何時發(fā)生,并且應(yīng)該根據(jù)需要發(fā)送適當(dāng)?shù)南?。但具體是什么時候呢?

我們應(yīng)該在三種情況下改變播放狀態(tài):

  • 當(dāng)激活新選項卡時,用戶只需從選項卡 A 切換到選項卡 B,
  • 當(dāng)前選項卡更新時,其 URL 已更改,或者
  • 當(dāng)選項卡關(guān)閉時 - 這是一個有點棘手的情況,因為當(dāng)用戶在播放音頻時關(guān)閉最后一個隱身窗口時,如果不調(diào)用上述兩種情況中的任何一種,就可能會發(fā)生這種情況。

所有情況都意味著我們可能正在訪問我們想要播放音頻的網(wǎng)站或者我們剛剛關(guān)閉/離開的網(wǎng)站。

言歸正傳,這里是更新后的 ts/background.ts 腳本,對這兩個事件做出反應(yīng):

// ts/offscreen-doc.ts
/**
 * Static class to manage the offscreen document
 */
export class OffscreenDoc {
    private static isCreating: Promise<boolean | void> | null;
    private constructor() {
        // private constructor to prevent instantiation
    }

    /**
     * Sets up the offscreen document if it doesn't exist
     * @param path - path to the offscreen document
     */
    static async setup(path: string) {
        if (!(await this.isDocumentCreated(path))) {
            await this.createOffscreenDocument(path);
        }
    }

    private static async createOffscreenDocument(path: string) {
        if (OffscreenDoc.isCreating) {
            await OffscreenDoc.isCreating;
        } else {
            OffscreenDoc.isCreating = chrome.offscreen.createDocument({
                url: path,
                reasons: ['AUDIO_PLAYBACK'],
                justification:
                    'Used to play audio independently from the opened tabs',
            });
            await OffscreenDoc.isCreating;
            OffscreenDoc.isCreating = null;
        }
    }

    private static async isDocumentCreated(path: string) {
        // Check all windows controlled by the service worker to see if one
        // of them is the offscreen document with the given path
        const offscreenUrl = chrome.runtime.getURL(path);
        const existingContexts = await chrome.runtime.getContexts({
            contextTypes: ['OFFSCREEN_DOCUMENT'],
            documentUrls: [offscreenUrl],
        });
        return existingContexts.length > 0;
    }
}

如您所見,toggleAudio 函數(shù)在這里是最重要的。首先,它設(shè)置屏幕外文檔。多次調(diào)用它是安全的,因為如果文檔已經(jīng)創(chuàng)建,它不會執(zhí)行任何操作。然后它決定是否應(yīng)該發(fā)送“播放”或“暫停”命令,具體取決于當(dāng)前選項卡的 URL。最后,它發(fā)送消息。正如我所提到的,sendMessage 沒有通用變體 (sendMessage),因此指定消息類型并不簡單,但 TS 滿足有助于確保我們發(fā)送的對象是 AudioMessage 類型。

還要注意頂部的兩個常量 - 在這里您指定要播放的音頻以及在哪個網(wǎng)站。

通過離屏文檔接收消息

最后,我們正在發(fā)送消息,所以現(xiàn)在是時候接收它們并播放一些音樂了?

為此,我們需要實現(xiàn) offscreen.html 使用的腳本。它是 dist/offscreen.js,所以這就是對應(yīng)的 ts/offscreen.ts 的樣子:

<!-- offscreen.html -->
<script src="dist/offscreen.js" type="module"></script>

簡而言之,如果我們還沒有創(chuàng)建 HTMLAudioElement,我們將使用提供的源來創(chuàng)建 HTMLAudioElement,然后播放/暫停它。出于打字目的,需要返回未定義。如果您對不同返回值的含義感興趣,請查看文檔

概括

Chrome extension  - implementing an extension

嘗試一下!訪問 www.example.com(或您設(shè)置的任何網(wǎng)站)并查看音頻是否正在播放。嘗試來回切換選項卡并驗證它是否正確停止和恢復(fù)。

請考慮到,如果您暫停音樂超過 30 秒,它將重新啟動,因為瀏覽器將終止 Service Worker! 以下是一些相關(guān)文檔。

總結(jié)我們所做的:

  • 我們使用所需的權(quán)限更新了manifest.json,以創(chuàng)建屏幕外文檔并監(jiān)控選項卡上的活動
  • 我們讓 Service Worker 觀察選項卡上的活動并向屏幕外文檔中的腳本發(fā)送足夠的命令
  • 我們開始通過一個腳本播放音頻,該腳本接收來自 Service Worker 的消息并控制屏幕外文檔的 DOM

我希望它清晰易懂!此擴(kuò)展有一個非常自然的進(jìn)展 - 讓用戶指定不同的網(wǎng)站并為每個網(wǎng)站分配不同的音頻。希望當(dāng)我有時間時我會補(bǔ)充這一點,并寫另一篇文章來描述我的方法。

現(xiàn)在,感謝您的閱讀!

以上是Chrome 擴(kuò)展程序 - 實現(xiàn)擴(kuò)展程序的詳細(xì)內(nèi)容。更多信息請關(guān)注PHP中文網(wǎng)其他相關(guān)文章!

本站聲明
本文內(nèi)容由網(wǎng)友自發(fā)貢獻(xiàn),版權(quán)歸原作者所有,本站不承擔(dān)相應(yīng)法律責(zé)任。如您發(fā)現(xiàn)有涉嫌抄襲侵權(quán)的內(nèi)容,請聯(lián)系admin@php.cn

熱AI工具

Undress AI Tool

Undress AI Tool

免費脫衣服圖片

Undresser.AI Undress

Undresser.AI Undress

人工智能驅(qū)動的應(yīng)用程序,用于創(chuàng)建逼真的裸體照片

AI Clothes Remover

AI Clothes Remover

用于從照片中去除衣服的在線人工智能工具。

Clothoff.io

Clothoff.io

AI脫衣機(jī)

Video Face Swap

Video Face Swap

使用我們完全免費的人工智能換臉工具輕松在任何視頻中換臉!

熱工具

記事本++7.3.1

記事本++7.3.1

好用且免費的代碼編輯器

SublimeText3漢化版

SublimeText3漢化版

中文版,非常好用

禪工作室 13.0.1

禪工作室 13.0.1

功能強(qiáng)大的PHP集成開發(fā)環(huán)境

Dreamweaver CS6

Dreamweaver CS6

視覺化網(wǎng)頁開發(fā)工具

SublimeText3 Mac版

SublimeText3 Mac版

神級代碼編輯軟件(SublimeText3)

Java vs. JavaScript:清除混亂 Java vs. JavaScript:清除混亂 Jun 20, 2025 am 12:27 AM

Java和JavaScript是不同的編程語言,各自適用于不同的應(yīng)用場景。Java用于大型企業(yè)和移動應(yīng)用開發(fā),而JavaScript主要用于網(wǎng)頁開發(fā)。

JavaScript評論:簡短說明 JavaScript評論:簡短說明 Jun 19, 2025 am 12:40 AM

JavascriptconcommentsenceenceEncorenceEnterential gransimenting,reading and guidingCodeeXecution.1)單inecommentsareusedforquickexplanations.2)多l(xiāng)inecommentsexplaincomplexlogicorprovideDocumentation.3)

如何在JS中與日期和時間合作? 如何在JS中與日期和時間合作? Jul 01, 2025 am 01:27 AM

JavaScript中的日期和時間處理需注意以下幾點:1.創(chuàng)建Date對象有多種方式,推薦使用ISO格式字符串以保證兼容性;2.獲取和設(shè)置時間信息可用get和set方法,注意月份從0開始;3.手動格式化日期需拼接字符串,也可使用第三方庫;4.處理時區(qū)問題建議使用支持時區(qū)的庫,如Luxon。掌握這些要點能有效避免常見錯誤。

為什么要將標(biāo)簽放在的底部? 為什么要將標(biāo)簽放在的底部? Jul 02, 2025 am 01:22 AM

PlacingtagsatthebottomofablogpostorwebpageservespracticalpurposesforSEO,userexperience,anddesign.1.IthelpswithSEObyallowingsearchenginestoaccesskeyword-relevanttagswithoutclutteringthemaincontent.2.Itimprovesuserexperiencebykeepingthefocusonthearticl

JavaScript與Java:開發(fā)人員的全面比較 JavaScript與Java:開發(fā)人員的全面比較 Jun 20, 2025 am 12:21 AM

JavaScriptIspreferredforredforwebdevelverment,而Javaisbetterforlarge-ScalebackendsystystemsandSandAndRoidApps.1)JavascriptexcelcelsincreatingInteractiveWebexperienceswebexperienceswithitswithitsdynamicnnamicnnamicnnamicnnamicnemicnemicnemicnemicnemicnemicnemicnemicnddommanipulation.2)

JavaScript:探索用于高效編碼的數(shù)據(jù)類型 JavaScript:探索用于高效編碼的數(shù)據(jù)類型 Jun 20, 2025 am 12:46 AM

javascripthassevenfundaMentalDatatypes:數(shù)字,弦,布爾值,未定義,null,object和symbol.1)numberSeadUble-eaduble-ecisionFormat,forwidevaluerangesbutbecautious.2)

什么是在DOM中冒泡和捕獲的事件? 什么是在DOM中冒泡和捕獲的事件? Jul 02, 2025 am 01:19 AM

事件捕獲和冒泡是DOM中事件傳播的兩個階段,捕獲是從頂層向下到目標(biāo)元素,冒泡是從目標(biāo)元素向上傳播到頂層。1.事件捕獲通過addEventListener的useCapture參數(shù)設(shè)為true實現(xiàn);2.事件冒泡是默認(rèn)行為,useCapture設(shè)為false或省略;3.可使用event.stopPropagation()阻止事件傳播;4.冒泡支持事件委托,提高動態(tài)內(nèi)容處理效率;5.捕獲可用于提前攔截事件,如日志記錄或錯誤處理。了解這兩個階段有助于精確控制JavaScript響應(yīng)用戶操作的時機(jī)和方式。

如何減少JavaScript應(yīng)用程序的有效載荷大??? 如何減少JavaScript應(yīng)用程序的有效載荷大??? Jun 26, 2025 am 12:54 AM

如果JavaScript應(yīng)用加載慢、性能差,問題往往出在payload太大,解決方法包括:1.使用代碼拆分(CodeSplitting),通過React.lazy()或構(gòu)建工具將大bundle拆分為多個小文件,按需加載以減少首次下載量;2.移除未使用的代碼(TreeShaking),利用ES6模塊機(jī)制清除“死代碼”,確保引入的庫支持該特性;3.壓縮和合并資源文件,啟用Gzip/Brotli和Terser壓縮JS,合理合并文件并優(yōu)化靜態(tài)資源;4.替換重型依賴,選用輕量級庫如day.js、fetch

See all articles