معرفی شرکت ها
esm-utils-4.1.2
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Utilities you'll need when migrating to ESModule.
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | esm-utils-4.1.2 |
| نام | esm-utils |
| نسخه کتابخانه | 4.1.2 |
| نگهدارنده | ['fisker'] |
| ایمیل نگهدارنده | ['lionkay@gmail.com'] |
| نویسنده | fisker Cheung |
| ایمیل نویسنده | lionkay@gmail.com |
| آدرس صفحه اصلی | git+https://github.com/fisker/esm-utils.git |
| آدرس اینترنتی | https://github.com/fisker/esm-utils#readme |
| مجوز | MIT |
# esm-utils
[![Build Status][github_actions_badge]][github_actions_link]
[![Coverage][coveralls_badge]][coveralls_link]
[![Npm Version][package_version_badge]][package_link]
[![MIT License][license_badge]][license_link]
[github_actions_badge]: https://img.shields.io/github/workflow/status/fisker/esm-utils/CI/main?style=flat-square
[github_actions_link]: https://github.com/fisker/esm-utils/actions?query=branch%3Amain
[coveralls_badge]: https://img.shields.io/coveralls/github/fisker/esm-utils/main?style=flat-square
[coveralls_link]: https://coveralls.io/github/fisker/esm-utils?branch=main
[license_badge]: https://img.shields.io/npm/l/esm-utils.svg?style=flat-square
[license_link]: https://github.com/fisker/esm-utils/blob/main/license
[package_version_badge]: https://img.shields.io/npm/v/esm-utils.svg?style=flat-square
[package_link]: https://www.npmjs.com/package/esm-utils
> Utilities you'll need when migrating to ESModule.
## Install
```bash
yarn add esm-utils
```
## Usage
<!-- prettier-ignore -->
```js
import createEsmUtils from 'esm-utils'
const {
dirname,
filename,
require,
importModule,
resolve,
readJson,
readJsonSync,
} = createEsmUtils(import.meta)
```
```js
/* Those named exports only accept absolute path or URL */
import {
importModule,
readJson,
loadJson,
readJsonSync,
loadJsonSync,
} from 'esm-utils'
```
## API
### `createEsmUtils(import.meta | URL | 'string')`
Returns an `object` with the following properties:
- `dirname` (alias `__dirname`)
- `filename` (alias `__filename`)
- `require`
- `importModule` (alias `import`)
- `resolve`
- `readJson` (alias `loadJson`)
- `readJsonSync` (alias `loadJsonSync`)
**Please read [this note](#you-dont-need-dirname-and-filename) before you use `dirname` and `filename`**
Sync version of `readJson`.
### `utils.importModule(string | URL, options?)`
Same as `import()`, but accepts absolute path (on Windows, `import('C:\\foo.js')` error throws when pass a absolute path starts with a drive letter).
#### `options.traceSyntaxError`
type: `boolean`\
default: `false`
Due to [this Node.js issue](https://github.com/nodejs/modules/issues/471), Node.js does not emit the location of the syntax error in the error thrown in dynamic `import()`.
When set `traceSyntaxError: true`, we'll try to get a better error message by running `node <file>` in a child process.
### `utils.readJson(string | URL)`
Returns `Promise<jsonObject>`.
### `utils.readJsonSync(string | URL)`
Sync version of `utils.readJson`
### `utils.resolve(string | URL)`
Ponyfill for [`import.meta.resolve`](https://nodejs.org/api/esm.html#esm_import_meta_resolve_specifier_parent).
If `import.meta.resolve` exits, use it directly, otherwise returns a simple wrapper of [import-meta-resolve](https://github.com/wooorm/import-meta-resolve).
## Import json file
With [`Import Assertions`](https://github.com/tc39/proposal-import-assertions)
```js
import foo from './foo.json' assert {type: 'json'}
```
```json
await import('./foo.json', {assert: {type: 'json'}})
```
With `require`, like CommonJS
```js
import createEsmUtils from 'esm-utils'
const {require} = createEsmUtils(import.meta)
const foo = require('./foo.json')
```
With `readJson` or `readJsonSync`
```js
import createEsmUtils from 'esm-utils'
const {readJson} = createEsmUtils(import.meta)
const foo = await readJson('./foo.json')
```
```js
import createEsmUtils from 'esm-utils'
const {readJsonSync} = createEsmUtils(import.meta)
const foo = readJsonSync('./foo.json')
```
## `importModule()`
Same as `utils.importModule()`, but only accept absolute path or URL.
## `readJson()` (alias `loadJson`)
Same as `utils.readJson()`, but only accept absolute path or URL.
## `readJsonSync()` (alias `loadJsonSync`)
Same as `utils.readJsonSync()`, but only accept absolute path or URL.
## You don't need `dirname` and `filename`
The `dirname` and `filename` supposed to be a quick solution when migrating to ES Modules. In most cases, you don't need them, because many APIs accept `URL` directly.
<!-- prettier-ignore -->
```js
/* BAD */
import fs from 'node:fs/promises'
import path from 'node:path'
import createEsmUtils from 'esm-utils'
const {dirname} = createEsmUtils(import.meta)
const buffer = await fs.readFile(
path.join(dirname, './path/to/file')
)
```
<!-- prettier-ignore -->
```js
/* GOOD */
import fs from 'node:fs/promises'
const buffer = await fs.readFile(
new URL('./path/to/file', import.meta.url)
)
```
نیازمندی
| مقدار | نام |
|---|---|
| 2.2.2 | import-meta-resolve |
| 2.1.0 | url-or-path |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| 16.19.1 | Npm |
نحوه نصب
نصب پکیج tgz esm-utils-4.1.2:
npm install esm-utils-4.1.2.tgz