The Deno Standard Library
Go to file
Michael Herzner b649680328
test(assert): improve test coverage (#4679)
* test(assert): improve test coverage

* chore: format

* chore: lint

* nits

---------

Co-authored-by: Asher Gomez <ashersaupingomez@gmail.com>
2024-05-07 00:08:16 +00:00
_tools docs(collections): complete documentation (#4664) 2024-05-06 16:51:20 +09:00
.devcontainer chore: add development container configuration (#1938) 2022-02-21 14:23:43 +11:00
.github chore: remove doc test workaround (#4675) 2024-05-06 13:16:10 +09:00
archive chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
assert test(assert): improve test coverage (#4679) 2024-05-07 00:08:16 +00:00
async chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
bytes chore: run @example JSDoc code snippets (#4669) 2024-05-06 13:28:15 +10:00
cli fix(cli): spinner support NO_COLOR (#4662) 2024-05-02 19:17:02 +09:00
collections docs(collections): complete documentation (#4664) 2024-05-06 16:51:20 +09:00
crypto chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
csv chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
data_structures chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
datetime chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
dotenv chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
encoding chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
expect test(assert): improve test coverage (#4679) 2024-05-07 00:08:16 +00:00
fmt chore: skip yanked versions (#4660) 2024-04-30 20:06:28 +09:00
front_matter chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
fs chore: skip yanked versions (#4660) 2024-04-30 20:06:28 +09:00
html chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
http chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
ini chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
internal test(assert): improve test coverage (#4679) 2024-05-07 00:08:16 +00:00
io chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
json chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
jsonc chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
log chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
media_types chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
msgpack chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
net chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
path chore: skip yanked versions (#4660) 2024-04-30 20:06:28 +09:00
regexp chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
semver chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
streams chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
testing chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
text chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
toml chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
ulid chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
url chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
uuid chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
webgpu chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
yaml chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09: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 BREAKING(console): remove std/console (#4643) 2024-04-26 19:54:59 +00:00
badge.svg chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
browser-compat.tsconfig.json chore: switch to JSR-oriented codebase (#4650) 2024-04-29 11:57:30 +09:00
deno.json docs(collections): complete documentation (#4664) 2024-05-06 16:51:20 +09:00
LICENSE chore: update copyright header (#1871) 2022-02-02 23:21:39 +09:00
README.md docs: update README for JSR (#4654) 2024-04-29 17:07:37 +10:00
Releases.md 0.224.0 (#4646) 2024-04-25 08:28:55 +05:30

Deno Standard Library

JSR @std codecov ci

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

Note: Newer versions of the Standard Library are now hosted on JSR. Older versions up till 0.224.0 are still available at deno.land/std.

Packages

The following list contains links to the Standard Library's packages and documentation:

Package Status Latest version
archive Unstable JSR
assert Settled JSR
async Settled JSR
bytes Settled JSR
cli Unstable JSR
collections Settled JSR
crypto Settled JSR
csv Settled JSR
data_structures Unstable JSR
datetime Unstable JSR
dotenv Unstable JSR
encoding Settled JSR
expect Unstable JSR
fmt Settled JSR
front_matter Settled JSR
fs Settled JSR
html Unstable JSR
http Unstable JSR
ini Unstable JSR
io Unstable JSR
json Settled JSR
jsonc Settled JSR
log Unstable JSR
media_types Settled JSR
msgpack Unstable JSR
net Unstable JSR
path Settled JSR
regexp Unstable JSR
semver Unstable JSR
streams Settled JSR
testing Settled JSR
text Unstable JSR
toml Settled JSR
ulid Unstable JSR
url Unstable JSR
uuid Settled JSR
webgpu Unstable JSR
yaml Settled JSR

Note: Settled status means a package is unlikely to have breaking changes, but has not yet achieved v1 status.

Stabilization

For a package to reach v1 (aka stable) status, it must meet the following requirements:

  1. Approved by four members of the internal team. There must be consensus that the API design is satisfactory and unlikely to change in the future.
  2. 100% documented, passing deno doc --lint checks and adhering to the documentation guidelines.
  3. Maximum possible test coverage
  4. No open issues or pull requests that might lead to breaking changes. For example, issues that suggest new non-breaking features are fine to exist at stabilization.

Architecture

Check out the architecture guide here.

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://jsr.io/@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://jsr.io/@std)