{"id":20597499,"url":"https://github.com/gerrproger/ext-helpers","last_synced_at":"2025-04-15T00:15:52.409Z","repository":{"id":71357081,"uuid":"205281266","full_name":"Gerrproger/ext-helpers","owner":"Gerrproger","description":"Small set of libraries for convenient browser extensions development","archived":false,"fork":false,"pushed_at":"2025-03-13T20:14:19.000Z","size":78,"stargazers_count":0,"open_issues_count":7,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-15T00:15:38.475Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Gerrproger.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-08-30T01:30:53.000Z","updated_at":"2024-08-23T05:19:58.000Z","dependencies_parsed_at":"2023-10-21T13:33:28.266Z","dependency_job_id":"0affbef9-a5b5-46db-b88d-9ca513fb427f","html_url":"https://github.com/Gerrproger/ext-helpers","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gerrproger%2Fext-helpers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gerrproger%2Fext-helpers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gerrproger%2Fext-helpers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gerrproger%2Fext-helpers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Gerrproger","download_url":"https://codeload.github.com/Gerrproger/ext-helpers/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248981268,"owners_count":21193147,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-16T08:22:45.754Z","updated_at":"2025-04-15T00:15:52.387Z","avatar_url":"https://github.com/Gerrproger.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ExtHelpers\n\n#### A set of libraries for convenient browser extensions development!\n\n- All libraries share unified version number.\n- All libraries are tested and support Chrome 50+ (and other Chromium based analogs).\n- No special manifest permissions needed unless otherwise specified for a particular library.\n- Each library does not depend on others but compatible with them (of course).\n- Each library is designed to perform one function and to speed up and simplify development when compared with using standard extensions api.\n- Unit tests will come out someday™.\n\n### Installation\n\n`yarn add ext-helpers` | `npm install ext-helpers`\n\nJust import library or include via script tag, or include script file using manifest. Then initialize its class.\\\nSome libraries need to be included in background or content scripts or into both, refer to the documentation for the specific library.\n\n```js\nimport ExtStorageManager from 'ext-helpers/dist/ext-storage-manager.js';\n```\n\nOr:\n\n```html\n\u003cscript src=\"/dist/ext-storage-manager.js\"\u003e\u003c/script\u003e\n```\n\nOr in `manifest.json`:\n\n```json\n{\n  \"manifest_version\": 2,\n  \"minimum_chrome_version\": \"50\",\n  \"permissions\": [\n    \"storage\",\n    \"\u003call_urls\u003e\"\n  ],\n  \"background\": {\n    \"scripts\": [\n      \"/deps/ext-storage-manager.min.js\",\n      \"/background.js\"\n    ]\n  },\n  \"content_scripts\": [\n    {\n      \"matches\": [\n        \"\u003call_urls\u003e\"\n      ],\n      \"js\": [\n        \"/deps/ext-storage-manager.min.js\",\n        \"/content.js\"\n      ]\n    }\n  ],\n  ...\n}\n```\n\nThen:\n\n```js\nconst storage = new ExtStorageManager({}, init);\n```\n\n## [ExtStorageManager](docs/ext-storage-manager.md)\n\nServes as a convenient wrapper over the storage api.\\\nAllows you to perform actions with the storage absolutely synchronously!\\\nConveniently access nested storage objects and subscribe to their changes.\\\nSet default storage contents.\n\n## [ExtAutoInject](docs/ext-auto-inject.md)\n\nAutomatically injects your content scripts during extension installation or update.\\\nUsers immediately see your extension working without having to reload tabs!\\\nConveniently allows you to interrupt the execution of old content scripts and initialize new (updated) ones.\\\nInjects content scripts and css specified in your manifest into suitable tabs and returns metadata such as extension version and update date.\n\n## [ExtActiveTabState](docs/ext-active-tab-state.md)\n\nAllows to get the metadata of the currently opened (focused) tab.\\\nMoreover, you can provide any data from the active tab (through content script)!\\\nConveniently subscribe to this data from specific pages using namespaces.\\\nIn sum, every time the user switches between tabs, you can receive data and the state of the active tab.\n\n## [ExtSinglePageOpener](docs/ext-single-page-opener.md)\n\nOpen any links in new tabs or windows only once.\\\nDoes not require any additional permissions (such as **tabs**)!\\\nConveniently allows you to create a new tab with the url or focus on an already opened with this url tab without creating a new one.\\\nAlso allows you to set tabs parameters, for example open in a new window without an omnibox.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgerrproger%2Fext-helpers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgerrproger%2Fext-helpers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgerrproger%2Fext-helpers/lists"}