https://github.com/small-tech/import-fresh
Import a fresh, uncached, version of an EcmaScript Module (ESM; aka ES6 module/JavaScript Module).
https://github.com/small-tech/import-fresh
Last synced: 9 days ago
JSON representation
Import a fresh, uncached, version of an EcmaScript Module (ESM; aka ES6 module/JavaScript Module).
- Host: GitHub
- URL: https://github.com/small-tech/import-fresh
- Owner: small-tech
- License: mit
- Created: 2021-02-22T11:04:33.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-02-23T13:37:55.000Z (over 5 years ago)
- Last Synced: 2025-11-22T09:19:52.805Z (7 months ago)
- Language: JavaScript
- Homepage:
- Size: 11.7 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# @small-tech/import-fresh
Import a fresh, uncached version of an EcmaScript Module (ESM; aka ES6 module/JavaScript Module).
---
___Note:__ This will leak memory and eventually crash your system. [Garbage collecting stale ESM modules is not a solved problem](https://github.com/nodejs/modules/issues/307) as of Feb, 2021. Do not use this in production._
---
## Syntax
```js
importFresh(absolutePathToModule)
```
## Example
In _module.mjs_:
```js
export default (() => Math.random())
```
In _index.mjs_:
```js
import path from 'path'
import importFresh from '@small-tech/importFresh'
console.log((await importFresh(path.resolve('./module.mjs'))).default)
console.log((await importFresh(path.resolve('./module.mjs'))).default)
```
Run _index.mjs_ and note that you see two different random numbers.
## Do you need this module?
Before you just `npm install` this, ask yourself if you really need it.
If you’re only going to use this in one place, you can cache bust using a single line of vanilla JavaScript:
e.g.,
```js
const myModule = await import(`./my-module?update=${new Date()}`)
```
(Bonus: you won’t have to use absolute paths.)
And if you want to use it from several places in the same file, you can just make a simple function:
```js
function importFresh(modulePath) {
return await import(`${modulePath}?update=${new Date()}`)
}
```
The only time this module really saves you any work is if you need this functionality from multiple files within your project.
So evaluate whether you need to use it and save a dependency if you don’t.
## Like this? Fund us!
[Small Technology Foundation](https://small-tech.org) is a tiny, independent not-for-profit.
We exist in part thanks to patronage by people like you. If you share [our vision](https://small-tech.org/about/#small-technology) and want to support our work, please [become a patron or donate to us](https://small-tech.org/fund-us) today and help us continue to exist.
## Copyright
© 2021 [Aral Balkan](https://ar.al), [Small Technology Foundation](https://small-tech.org).
## License
[MIT](https://opensource.org/licenses/MIT)