https://github.com/blackglory/eternity
🌲 A minimalist JavaScript user script loader and manager for modern browsers.
https://github.com/blackglory/eternity
chrome-extension esm manifest-v3 typescript unpublished
Last synced: 21 days ago
JSON representation
🌲 A minimalist JavaScript user script loader and manager for modern browsers.
- Host: GitHub
- URL: https://github.com/blackglory/eternity
- Owner: BlackGlory
- License: mit
- Created: 2021-01-13T15:07:53.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2026-02-24T13:23:42.000Z (3 months ago)
- Last Synced: 2026-02-24T18:33:08.504Z (3 months ago)
- Topics: chrome-extension, esm, manifest-v3, typescript, unpublished
- Language: TypeScript
- Homepage:
- Size: 1.2 MB
- Stars: 26
- Watchers: 2
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Eternity
![eternity-logo]
A minimalist JavaScript user script loader and manager for modern browsers.
In order to use this extension, you need Chrome 120 or above, and [developer mode] enabled.
[developer mode]: https://developer.chrome.com/docs/extensions/reference/userScripts/#developer-mode-for-extension-users
[eternity-logo]: src/assets/images/icon-128.png
## Supported browsers and platforms
- [x] Chrome
## When do you need this?
When you want to load normal JavaScript scripts as user scripts, and
- You need [ES modules].
- You don't need [Greasemonkey API].
- You always want user scripts to run as early as possible.
[ES modules]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import
[Greasemonkey API]: https://wiki.greasespot.net/Greasemonkey_Manual:API
## Example
```js
// @name Hello World
// @match
// @world MAIN
import { addStyleSheet } from 'https://esm.sh/userstyle@0.2.1'
addStyleSheet(`
*:before {
content: 'Hello'
}
*:after {
content: 'World'
}
`)
```
## Metadata
You need to write the metadata as comments at the beginning of the script,
refer to the example for the format.
### @name
The name of the user script.
### @match
Specifies which pages this user script will be injected into.
See [Chrome Extensions match patterns].
[Chrome Extensions match patterns]: https://developer.chrome.com/docs/extensions/mv3/match_patterns/
You can specify multiple patterns via multiple `@match`.
### @update-url
The update URL of the user script.
This is optional, Eternity accesses the URL to keep the user script up to date.
You can specify multiple update URLs via multiple `@update-url`.
Eternity will check them one by one in order until a usable user script is found.
### @world
[The JavaScript world] for a user script to execute within.
This is optional, the default value is the same as the extension API.
[The JavaScript world]: https://developer.chrome.com/docs/extensions/reference/api/userScripts#type-ExecutionWorld