{"id":16266127,"url":"https://github.com/intevel/inspect-browser-storage","last_synced_at":"2026-06-19T21:31:44.110Z","repository":{"id":103218214,"uuid":"560102395","full_name":"Intevel/inspect-browser-storage","owner":"Intevel","description":"⚗️ Read and write local browser/electron storage","archived":false,"fork":false,"pushed_at":"2022-10-31T22:08:17.000Z","size":82,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-02T00:41:53.784Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","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/Intevel.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2022-10-31T18:35:27.000Z","updated_at":"2023-01-25T16:11:55.000Z","dependencies_parsed_at":"2023-04-29T14:32:13.603Z","dependency_job_id":null,"html_url":"https://github.com/Intevel/inspect-browser-storage","commit_stats":{"total_commits":4,"total_committers":1,"mean_commits":4.0,"dds":0.0,"last_synced_commit":"13ba964c3a8e81db16518414e14bbeb847b89377"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Intevel%2Finspect-browser-storage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Intevel%2Finspect-browser-storage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Intevel%2Finspect-browser-storage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Intevel%2Finspect-browser-storage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Intevel","download_url":"https://codeload.github.com/Intevel/inspect-browser-storage/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247865149,"owners_count":21009228,"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-10-10T17:21:57.895Z","updated_at":"2025-11-02T09:02:57.422Z","avatar_url":"https://github.com/Intevel.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ⚗️ inspect-browser-storage\n\n[![npm version][npm-version-src]][npm-version-href]\n[![npm downloads][npm-downloads-src]][npm-downloads-href]\n[![Github Actions][github-actions-src]][github-actions-href]\n\n\u003e With this package you can locally and programmatically modify the LocalStorage and SessionStorage of a browser. This also applies to an Browser based Electron app.\n\n⚠️ The default paths currently belong to chromium, other browsers will be added in the next versions. But you can set `dbPath` option for other databases. ⚠️\n\n## Usage\n\nInstall package:\n\n```sh\n# npm\nnpm install inspect-browser-storage\n\n# yarn\nyarn install inspect-browser-storage\n\n# pnpm\npnpm install inspect-browser-storage\n```\n\nImport:\n\n```js\n// ESM\nimport { writeToStorage, readFromStorage } from 'inspect-browser-storage'\n\n// CommonJS\nconst { writeToStorage, readFromStorage } = require('inspect-browser-storage')\n```\n\n### `readFromStorage(domain, key, options?)`\n\n**Example:**\n\n```js\nconst data = await readFromStorage('test-application.de', 'auth_token')\n// -\u003e Returns the value of the key 'auth_token' in the localStorage of 'https://test-application.de/'\n```\n\n**Options:**\n\n- `dbPath`: (string) The domain in the storage.\n- `key`: (string) the key of the item in storage\n- `options?`: (object) Options are defaults and get merged with the default options.\n  - `dbPath`: (string) Path to the database, default is the chromium path on your system\n  - `autoUnlink`: (boolean) If true, the package will try to unlock the database LOCK File. Default is true\n  - `protocol`: (string) Which protocol should be added to the domain, can be https:// or http://. Default is https://\n  - `storage`: (string) Define which storage it should use, can be `localStorage` or `sessionStorage`. Default is `localStorage`\n\n### `writeToStorage(domain, key, value, options?)`\n\n**Example:**\n\n```js\nconst data = await writeToStorage('test-application.de', 'auth_token', 'eyDasdlok.......')\n```\n\n**Options:**\n\n- `dbPath`: (string) The domain in the storage.\n- `key`: (string) the key of the item in storage\n- `value`: (string) the value which should set to the key in storage\n- `options?`: (object) Options are defaults and get merged with the default options.\n  - `dbPath`: (string) Path to the database, default is the chromium path on your system\n  - `autoUnlink`: (boolean) If true, the package will try to unlock the database LOCK File. Default is true\n  - `protocol`: (string) Which protocol should be added to the domain, can be https:// or http://. Default is https://\n  - `storage`: (string) Define which storage it should use, can be `localStorage` or `sessionStorage`. Default is `localStorage`\n\n## 💻 Development\n\n- Clone this repository\n- Install dependencies using `yarn install`\n- Run watcher build `yarn dev`\n\n## License\n\nMade with 💚 by Conner Bachmann. \u003cbr /\u003e\nThe idea originally comes from [Jan Bölsche](https://github.com/regular) and his package [chrome-localstorage](https://github.com/regular/chrome-localstorage/)\n\nPublished under [MIT License](./LICENSE).\n\n\u003c!-- Badges --\u003e\n[npm-version-src]: https://img.shields.io/npm/v/inspect-browser-storage?style=flat-square\n[npm-version-href]: https://npmjs.com/package/inspect-browser-storage\n\n[npm-downloads-src]: https://img.shields.io/npm/dm/inspect-browser-storage?style=flat-square\n[npm-downloads-href]: https://npmjs.com/package/inspect-browser-storage\n\n[github-actions-src]: https://img.shields.io/github/workflow/status/Intevel/inspect-browser-storage/ci/main?style=flat-square\n[github-actions-href]: https://github.com/Intevel/inspect-browser-storage/actions?query=workflow%3Aci\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fintevel%2Finspect-browser-storage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fintevel%2Finspect-browser-storage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fintevel%2Finspect-browser-storage/lists"}