# node:timers/promises

<!-- Generated from reports/manifest.json by `node ./scripts/api-docs.ts`.
     Do not edit this file. Run `pnpm run docs` to rebuild it.
     Node v26.7.0, commit 975a25d, 2026-08-27T21:51:46.116Z. -->

# `node:timers/promises`

## Import

```js
import timers_promises from "nstdlib/timers/promises";
```

> [!NOTE]
> Its behavior matches Node.js. Details: the same scheduler, compared against the host builtin.

## Runtime support

| Where it runs | Status | Export coverage | Details |
| ------------- | ------ | --------------- | ------- |
| **nstd** | ⚠️ some support | – | 43/59 of Node's own eligible tests pass under nstd (filed under `timers`, the parent module). |
| **Browser** | ❔ not tested | 100% of Node.js | It imports with the small process shim. 4/4 Node.js exports are available. No module-specific behavior test ran. |
| **Node.js (host)** | ✅ works | 100% of Node.js | 4/4 exports. |

## Exports (4 of 4)

Each cell shows what happens when code reads an export:

- ✅ Available through every import style. A named error also counts.
- ⚠️ Available through only some import styles.
- ❔ The export exists but has no value.
- ❌ The export does not exist.
- – This environment was not measured.

| Export | Node.js | nstdlib | browser |
| ------ | ------- | ------- | ------- |
| `scheduler` | <span title="Available" aria-label="Available">✅</span> | <span title="Available" aria-label="Available">✅</span> | <span title="Available" aria-label="Available">✅</span> |
| `setImmediate` | <span title="Available" aria-label="Available">✅</span> | <span title="Available" aria-label="Available">✅</span> | <span title="Available" aria-label="Available">✅</span> |
| `setInterval` | <span title="Available" aria-label="Available">✅</span> | <span title="Available" aria-label="Available">✅</span> | <span title="Available" aria-label="Available">✅</span> |
| `setTimeout` | <span title="Available" aria-label="Available">✅</span> | <span title="Available" aria-label="Available">✅</span> | <span title="Available" aria-label="Available">✅</span> |