The Deno Standard Library
Go to file
2024-02-29 13:52:53 +09:00
_tools refactor: make the code work under verbatimModuleSyntax (#4406) 2024-02-27 21:57:25 +00:00
.devcontainer chore: add development container configuration (#1938) 2022-02-21 14:23:43 +11:00
.github chore: use 'release' event for triggering jsr publish (#4370) 2024-02-22 16:11:40 +09:00
archive refactor: make the code work under verbatimModuleSyntax (#4406) 2024-02-27 21:57:25 +00:00
assert feat(assert): optional reason param for unreachable (#4404) (#4405) 2024-02-29 06:58:02 +12:00
async refactor: make the code work under verbatimModuleSyntax (#4406) 2024-02-27 21:57:25 +00:00
bytes refactor(bytes): prepare for noUncheckedIndexedAccess (#4119) 2024-01-06 08:37:29 +11:00
cli refactor: make the code work under verbatimModuleSyntax (#4406) 2024-02-27 21:57:25 +00:00
collections feat(collections): add pick and omit (#4218) 2024-02-25 20:51:37 +09:00
console refactor(console): prepare for noUncheckedIndexedAccess (#4269) 2024-02-02 16:42:48 +09:00
crypto refactor: make the code work under verbatimModuleSyntax (#4406) 2024-02-27 21:57:25 +00:00
csv refactor: make the code work under verbatimModuleSyntax (#4406) 2024-02-27 21:57:25 +00:00
data_structures refactor: make the code work under verbatimModuleSyntax (#4406) 2024-02-27 21:57:25 +00:00
datetime feat(datetime): format() options (#4285) 2024-02-09 19:35:14 +09:00
dotenv refactcor(dotenv): prepare for noUncheckedIndexedAccess (#4261) 2024-02-02 08:34:42 +11:00
encoding refactor: make the code work under verbatimModuleSyntax (#4406) 2024-02-27 21:57:25 +00:00
expect feat(expect): add asymmetric matchers (any, anything, arrayContaining) (#4366) 2024-02-28 13:07:50 +09:00
flags docs: replace markdown hyperlink syntax with {@link} tag where necessary. (#4253) 2024-02-01 09:19:46 +11:00
fmt docs(fmt/colors): warn that dim is incompatible accross terminals (#4303) 2024-02-12 12:15:58 +11:00
front_matter refactor: make the code work under verbatimModuleSyntax (#4406) 2024-02-27 21:57:25 +00:00
fs fix(fs/ensure_symlink): check symlink is pointing the given target (#4371) 2024-02-28 11:50:33 +09:00
html refactor(html): prepare for noUncheckedIndexedAccess (#4297) 2024-02-12 14:12:28 +11:00
http refactor: make the code work under verbatimModuleSyntax (#4406) 2024-02-27 21:57:25 +00:00
ini refactor: make the code work under verbatimModuleSyntax (#4406) 2024-02-27 21:57:25 +00:00
io refactor: make the code work under verbatimModuleSyntax (#4406) 2024-02-27 21:57:25 +00:00
json refactor: make the code work under verbatimModuleSyntax (#4406) 2024-02-27 21:57:25 +00:00
jsonc docs(jsonc): add module-level docs (#4402) 2024-02-27 19:28:34 +00:00
log refactor: make the code work under verbatimModuleSyntax (#4406) 2024-02-27 21:57:25 +00:00
media_types refactor: make the code work under verbatimModuleSyntax (#4406) 2024-02-27 21:57:25 +00:00
msgpack refactor: make the code work under verbatimModuleSyntax (#4406) 2024-02-27 21:57:25 +00:00
net refactor(using): use using keyword for Explicit Resource Management (#4143) 2024-01-15 08:35:50 +11:00
path refactor: make the code work under verbatimModuleSyntax (#4406) 2024-02-27 21:57:25 +00:00
permissions docs: fix broken {@link} hyperlinks (#4241) 2024-01-26 01:08:29 +11:00
regexp docs(regexp): complete documentation (#4319) 2024-02-13 07:32:41 +11:00
semver chore(semver): format test names (#4379) 2024-02-29 16:00:20 +12:00
streams refactor: make the code work under verbatimModuleSyntax (#4406) 2024-02-27 21:57:25 +00:00
testing refactor: make the code work under verbatimModuleSyntax (#4406) 2024-02-27 21:57:25 +00:00
text refactor(text): prepare for noUncheckedIndexedAccess (#4148) 2024-01-11 07:33:57 +11:00
toml refatcor(toml): prepare for noUncheckedIndexedAccess (#4274) 2024-02-04 20:23:55 +09:00
ulid refactor: make the code work under verbatimModuleSyntax (#4406) 2024-02-27 21:57:25 +00:00
url refactor(url): prepare for noUncheckedIndexedAccess (#4145) 2024-01-11 06:59:09 +11:00
uuid feat(uuid): add type predicate return type to validate (v4) (#4301) 2024-02-29 13:52:53 +09:00
webgpu docs: fix broken {@link} hyperlinks (#4241) 2024-01-26 01:08:29 +11:00
yaml refactor: make the code work under verbatimModuleSyntax (#4406) 2024-02-27 21:57:25 +00:00
.editorconfig chore: fix .editorconfig syntax (#4376) 2024-02-24 09:51:17 +09:00
.gitattributes Remove std/node, it was merged into Deno itself (#3206) 2023-02-22 10:28:55 -05:00
.gitignore chore: ignore /docs folder (#4112) 2024-01-05 18:55:55 +11:00
badge.svg docs: "Built with deno_std" badge (#3797) 2023-11-24 13:54:28 +11:00
browser-compat.tsconfig.json fix: improve type safety for browser-compatible modules (#995) 2021-07-06 11:15:37 +09:00
deno.json chore(internal): remove warnOnDeprecatedApi() and internal folder (#4359) 2024-02-20 20:00:58 +11:00
LICENSE chore: update copyright header (#1871) 2022-02-02 23:21:39 +09:00
README.md docs: ignore bad snippet examples (#4388) 2024-02-26 19:46:10 +11:00
Releases.md 0.217.0 (#4369) 2024-02-22 01:57:01 +01:00
version.ts 0.217.0 (#4369) 2024-02-22 01:57:01 +01:00

Deno Standard Library

codecov ci

High-quality APIs for Deno and the web. Use fearlessly.

Get Started

import { copy } from "https://deno.land/std@$STD_VERSION/fs/copy.ts";

await copy("./foo", "./bar");

See here for recommended usage patterns.

Documentation

Check out the documentation here.

  1. Include the version of the library in the import specifier.

    Good:

    import { copy } from "https://deno.land/std@$STD_VERSION/fs/copy.ts";
    
  2. Only import modules that you require.

    Bad (when using only one function):

    import * as fs from "https://deno.land/std@$STD_VERSION/fs/mod.ts";
    

    Good (when using only one function):

    import { copy } from "https://deno.land/std@$STD_VERSION/fs/copy.ts";
    

    Good (when using multiple functions):

    import * as fs from "https://deno.land/std@$STD_VERSION/fs/mod.ts";
    
  3. Do not import symbols with a name prefixed by an underscore (they're not intended for public use).

    Bad:

    import { _format } from "https://deno.land/std@$STD_VERSION/path/_common/format.ts";
    
  4. Do not import modules with a directory or filename prefixed by an underscore (they're not intended for public use).

    Bad:

    import { createLPS } from "https://deno.land/std@$STD_VERSION/streams/_common.ts";
    

    Good:

    import { TextLineStream } from "https://deno.land/std@$STD_VERSION/streams/text_line_stream.ts";
    
  5. Do not import test modules or test data.

    Bad:

    import { test } from "https://deno.land/std@$STD_VERSION/front_matter/test.ts";
    

Stability

Sub-module Status
archive Unstable
assert Stable
async Stable
bytes Stable
cli Unstable
collections Stable
console Unstable
crypto Stable
csv Stable
data_structures Unstable
datetime Unstable
dotenv Unstable
encoding Stable
expect Unstable
flags Unstable
fmt Stable
front_matter Stable
fs Stable
html Unstable
http Unstable
ini Unstable
io Unstable
json Stable
jsonc Stable
log Unstable
media_types Stable
msgpack Unstable
net Unstable
path Stable
permissions Deprecated
regexp Unstable
semver Unstable
streams Stable
testing Stable
text Unstable
toml Stable
ulid Unstable
url Unstable
uuid Stable
webgpu Unstable
yaml Stable

For background and discussions regarding the stability of the following sub-modules, see #3489.

Design

Minimal Exports

Files are structured to minimize the number of dependencies they incur and the amount of effort required to manage them, both for the maintainer and the user. In most cases, only a single function or class, alongside its related types, are exported. In other cases, functions that incur negligible dependency overhead will be grouped together in the same file.

Deprecation Policy

We deprecate the APIs in the Standard Library when they get covered by new JavaScript language APIs or new Web Standard APIs. These APIs are usually removed after 3 minor versions.

If you still need to use such APIs after the removal for some reason (for example, the usage in Fresh island), please use the URL pinned to the version where they are still available.

For example, if you want to keep using readableStreamFromIterable, which was deprecated and removed in favor of ReadableStream.from in v0.195.0, please use the import URL pinned to v0.194.0:

import { readableStreamFromIterable } from "https://deno.land/std@0.194.0/streams/readable_stream_from_iterable.ts";

Contributing

Check out the contributing guidelines here.

Releases

The Standard Library is versioned independently of the Deno CLI. This will change once the Standard Library is stabilized. See here for the compatibility of different versions of the Deno Standard Library and the Deno CLI.

A new minor version of the Standard Library is published at the same time as every new version of the Deno CLI (including patch versions).

Badge

Built with the Deno Standard Library

<a href="https://deno.land/std">
  <img
    width="135"
    height="20"
    src="https://raw.githubusercontent.com/denoland/deno_std/main/badge.svg"
    alt="Built with the Deno Standard Library"
  />
</a>
[![Built with the Deno Standard Library](https://raw.githubusercontent.com/denoland/deno_std/main/badge.svg)](https://deno.land/std)