foster/denoland-deno
1
0
Fork 0
mirror of https://github.com/denoland/deno.git synced 2024-12-25 08:39:09 -05:00
Code Issues Packages 1 Wiki Activity
denoland-deno/docs/runtime/stability.md
Luca Casonato 45f9b32ef0
Docs for deno test + minor other changes (#5185) 
* Added fs events example.
* Added docs for `deno test`.
* Renamed file server example.
* Unified markdown code types.
* Removed plugin topics from TOC.
* Fixed links.
2020-05-10 03:09:42 +02:00

1 KiB
Raw Blame History

Stability

As of Deno 1.0.0, the Deno namespace APIs are stable. That means that we will strive to make code working under 1.0.0 continue to work in future versions.

However, not all of Deno's features are ready for production yet. Features which are not ready because they are still in draft phase are locked behind the --unstable command line flag. Passing this flag does a few things:

  • It enables the use of unstable APIs during runtime.
  • It adds the lib.deno.unstable.d.ts file to the list of TypeScript definitions that are used for type checking. This includes the output of deno types.

You should be aware that unstable APIs have probably not undergone a security review, are likely to have breaking API changes in the future and are not ready for production.

Furthermore Deno's standard modules (https://deno.land/std/) are not yet stable. We version the standard modules differently from the CLI to reflect this.