Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
- Notifications
You must be signed in to change notification settings - Fork 36.7k
doc: update stability index#943
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Uh oh!
There was an error while loading. Please reload this page.
Changes from all commits
File filter
Filter by extension
Conversations
Uh oh!
There was an error while loading. Please reload this page.
Jump to
Uh oh!
There was an error while loading. Please reload this page.
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,6 +1,6 @@ | ||
| # console | ||
| Stability: 4 - API Frozen | ||
| Stability: 2 - Stable | ||
| * {Object} | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,6 +1,6 @@ | ||
| # Debugger | ||
| Stability: 3 - Stable | ||
| Stability: 2 - Stable | ||
| <!-- type=misc --> | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,6 +1,6 @@ | ||
| # UDP / Datagram Sockets | ||
| Stability: 3 - Stable | ||
| Stability: 2 - Stable | ||
| <!-- name=dgram --> | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,6 +1,6 @@ | ||
| # DNS | ||
| Stability: 3 - Stable | ||
| Stability: 2 - Stable | ||
| Use `require('dns')` to access this module. | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,6 +1,6 @@ | ||
| # Domain | ||
| Stability: 2 - Unstable | ||
| Stability: 0 - Deprecated | ||
Contributor There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Not yet? Contributor There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. By deprecated we mean "DON'T USE THIS!" :) | ||
| **This module is pending deprecation**. Once a replacement API has been | ||
| finalized, this module will be fully deprecated. Most end users should | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,6 +1,6 @@ | ||
| # Events | ||
| Stability: 4 - API Frozen | ||
| Stability: 2 - Stable | ||
| <!--type=module--> | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,6 +1,6 @@ | ||
| # File System | ||
| Stability: 3 - Stable | ||
| Stability: 2 - Stable | ||
| <!--name=fs--> | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,6 +1,6 @@ | ||
| # HTTP | ||
| Stability: 3 - Stable | ||
| Stability: 2 - Stable | ||
| To use the HTTP server and client one must `require('http')`. | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,6 +1,6 @@ | ||
| # Modules | ||
| Stability: 5 - Locked | ||
| Stability: 3 - Locked | ||
| <!--name=module--> | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,6 +1,6 @@ | ||
| # OS | ||
| Stability: 4 - API Frozen | ||
| Stability: 2 - Stable | ||
| Provides a few basic operating-system related utility functions. | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,6 +1,6 @@ | ||
| # Query String | ||
| Stability: 3 - Stable | ||
| Stability: 2 - Stable | ||
| <!--name=querystring--> | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,6 +1,6 @@ | ||
| # Smalloc | ||
| Stability: 1 - Experimental | ||
| Stability: 2 - Stable | ||
| ## Class: smalloc | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,6 +1,6 @@ | ||
| # TLS (SSL) | ||
| Stability: 3 - Stable | ||
| Stability: 2 - Stable | ||
| Use `require('tls')` to access this module. | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,6 +1,6 @@ | ||
| # Executing JavaScript | ||
| Stability: 3 - Stable | ||
| Stability: 2 - Stable | ||
| <!--name=vm--> | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,6 +1,6 @@ | ||
| # Zlib | ||
| Stability: 3 - Stable | ||
| Stability: 2 - Stable | ||
| You can access this module with: | ||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
If "Backwards-compatibility is guaranteed." is removed, how can my npm modules declare which versions of the built-in modules like
urlandpaththey are compatible with?There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
See the above:
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
That's not even an answer to the only question in my comment.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The whole idea is that backwards compatibility is guaranteed by semver, stability levels don't really matter
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
How do I, as a module author, assert this semver in my
package.json? There is noengines.iojsfield I'm aware of.There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There is currently no mechanism for this outside of feature detection. A breaking change in a stable API must demonstrate enough value to justify the breakage – that bar is very high.