foster/denoland-deno
1
0
Fork 0
mirror of https://github.com/denoland/deno.git synced 2024-12-22 15:24:46 -05:00
Code Issues Packages 1 Wiki Activity

docs: remove unstable messages (#15878)

Browse source
This commit is contained in:
Leo Kettmeir 2022-09-13 02:23:34 +01:00 committed by GitHub
parent 233d5422fd
commit b4e618315a
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 47 additions and 126 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

173
cli/dts/lib.deno.unstable.d.ts vendored
View file

@ -191,9 +191,7 @@ declare namespace Deno {
fn: () => void | Promise<void>, fn: () => void | Promise<void>,
): void; ): void;
/** /** This API is under consideration to determine if permissions are required to call it.
* **UNSTABLE**: New API, yet to be vetted. This API is under consideration to
* determine if permissions are required to call it.
* *
* Retrieve the process umask. If `mask` is provided, sets the process umask. * Retrieve the process umask. If `mask` is provided, sets the process umask.
* This call always returns what the umask was before the call. * This call always returns what the umask was before the call.
@ -210,9 +208,7 @@ declare namespace Deno {
*/ */
export function umask(mask?: number): number; export function umask(mask?: number): number;
/** **UNSTABLE**: New API, yet to be vetted. /** Gets the size of the console as columns/rows.
*
* Gets the size of the console as columns/rows.
* *
* ```ts * ```ts
* const { columns, rows } = Deno.consoleSize(Deno.stdout.rid); * const { columns, rows } = Deno.consoleSize(Deno.stdout.rid);
@ -227,7 +223,7 @@ declare namespace Deno {
rows: number; rows: number;
}; };
/** **Unstable** There are questions around which permission this needs. And /** There are questions around which permission this needs. And
* maybe should be renamed (loadAverage?) * maybe should be renamed (loadAverage?)
* *
* Returns an array containing the 1, 5, and 15 minute load averages. The * Returns an array containing the 1, 5, and 15 minute load averages. The
@ -247,7 +243,7 @@ declare namespace Deno {
*/ */
export function loadavg(): number[]; export function loadavg(): number[];
/** **Unstable** new API. yet to be vetted. Under consideration to possibly move to /** Under consideration to possibly move to
* Deno.build or Deno.versions and if it should depend sys-info, which may not * Deno.build or Deno.versions and if it should depend sys-info, which may not
* be desireable. * be desireable.
* *
@ -264,9 +260,7 @@ declare namespace Deno {
*/ */
export function osRelease(): string; export function osRelease(): string;
/** **Unstable** new API. yet to be vetted. /** Displays the total amount of free and used physical and swap memory in the
*
* Displays the total amount of free and used physical and swap memory in the
* system, as well as the buffers and caches used by the kernel. * system, as well as the buffers and caches used by the kernel.
* *
* This is similar to the `free` command in Linux * This is similar to the `free` command in Linux
@ -325,9 +319,7 @@ declare namespace Deno {
mac: string; mac: string;
} }
/** **Unstable** new API. yet to be vetted. /** Returns an array of the network interface informations.
*
* Returns an array of the network interface informations.
* *
* ```ts * ```ts
* console.log(Deno.networkInterfaces()); * console.log(Deno.networkInterfaces());
@ -340,9 +332,7 @@ declare namespace Deno {
*/ */
export function networkInterfaces(): NetworkInterfaceInfo[]; export function networkInterfaces(): NetworkInterfaceInfo[];
/** **Unstable** new API. yet to be vetted. /** Returns the user id of the process on POSIX platforms. Returns null on windows.
*
* Returns the user id of the process on POSIX platforms. Returns null on windows.
* *
* ```ts * ```ts
* console.log(Deno.getUid()); * console.log(Deno.getUid());
@ -355,9 +345,7 @@ declare namespace Deno {
*/ */
export function getUid(): number | null; export function getUid(): number | null;
/** **Unstable** new API. yet to be vetted. /** Returns the group id of the process on POSIX platforms. Returns null on windows.
*
* Returns the group id of the process on POSIX platforms. Returns null on windows.
* *
* ```ts * ```ts
* console.log(Deno.getGid()); * console.log(Deno.getGid());
@ -593,9 +581,7 @@ declare namespace Deno {
*/ */
export type PointerValue = number | bigint; export type PointerValue = number | bigint;
/** **UNSTABLE**: Unsafe and new API, beware! /** An unsafe pointer to a memory location for passing and returning pointers
*
* An unsafe pointer to a memory location for passing and returning pointers
* to and from the FFI. * to and from the FFI.
* *
* @category FFI * @category FFI
@ -607,9 +593,7 @@ declare namespace Deno {
static of(value: Deno.UnsafeCallback | TypedArray): PointerValue; static of(value: Deno.UnsafeCallback | TypedArray): PointerValue;
} }
/** **UNSTABLE**: Unsafe and new API, beware! /** An unsafe pointer view to a memory location as specified by the `pointer`
*
* An unsafe pointer view to a memory location as specified by the `pointer`
* value. The `UnsafePointerView` API mimics the standard built in interface * value. The `UnsafePointerView` API mimics the standard built in interface
* `DataView` for accessing the underlying types at an memory location * `DataView` for accessing the underlying types at an memory location
* (numbers, strings and raw bytes). * (numbers, strings and raw bytes).
@ -665,10 +649,7 @@ declare namespace Deno {
): void; ): void;
} }
/** /** An unsafe pointer to a function, for calling functions that are not
* **UNSTABLE**: Unsafe and new API, beware!
*
* An unsafe pointer to a function, for calling functions that are not
* present as symbols. * present as symbols.
* *
* @category FFI * @category FFI
@ -699,10 +680,7 @@ declare namespace Deno {
...args: FromNativeParameterTypes<Parameters> ...args: FromNativeParameterTypes<Parameters>
) => ToNativeResultType<Result>; ) => ToNativeResultType<Result>;
/** /** An unsafe function pointer for passing JavaScript functions
* **UNSTABLE**: Unsafe and new API, beware!
*
* An unsafe function pointer for passing JavaScript functions
* as C function pointers to ffi calls. * as C function pointers to ffi calls.
* *
* The function pointer remains valid until the `close()` method is called. * The function pointer remains valid until the `close()` method is called.
@ -768,9 +746,7 @@ declare namespace Deno {
close(): void; close(): void;
} }
/** **UNSTABLE**: Unsafe and new API, beware! /** Opens a dynamic library and registers symbols
*
* Opens a dynamic library and registers symbols
* *
* @category FFI * @category FFI
*/ */
@ -784,9 +760,7 @@ declare namespace Deno {
cbreak: boolean; cbreak: boolean;
}; };
/** **UNSTABLE**: new API, yet to be vetted /** Set TTY to be under raw mode or not. In raw mode, characters are read and
*
* Set TTY to be under raw mode or not. In raw mode, characters are read and
* returned as is, without being processed. All special processing of * returned as is, without being processed. All special processing of
* characters by the terminal is disabled, including echoing input characters. * characters by the terminal is disabled, including echoing input characters.
* Reading from a TTY device in raw mode is faster than reading from a TTY * Reading from a TTY device in raw mode is faster than reading from a TTY
@ -808,7 +782,7 @@ declare namespace Deno {
options?: SetRawOptions, options?: SetRawOptions,
): void; ): void;
/** **UNSTABLE**: needs investigation into high precision time. /** Needs investigation into high precision time.
* *
* Synchronously changes the access (`atime`) and modification (`mtime`) times * Synchronously changes the access (`atime`) and modification (`mtime`) times
* of a file system object referenced by `path`. Given times are either in * of a file system object referenced by `path`. Given times are either in
@ -829,7 +803,7 @@ declare namespace Deno {
mtime: number | Date, mtime: number | Date,
): void; ): void;
/** **UNSTABLE**: needs investigation into high precision time. /** Needs investigation into high precision time.
* *
* Changes the access (`atime`) and modification (`mtime`) times of a file * Changes the access (`atime`) and modification (`mtime`) times of a file
* system object referenced by `path`. Given times are either in seconds * system object referenced by `path`. Given times are either in seconds
@ -863,8 +837,7 @@ declare namespace Deno {
}, },
>(opt: T): Process<T>; >(opt: T): Process<T>;
/** **UNSTABLE**: New API, yet to be vetted. Additional consideration is still /** Additional consideration is still necessary around the permissions required.
* necessary around the permissions required.
* *
* Get the `hostname` of the machine the Deno process is running on. * Get the `hostname` of the machine the Deno process is running on.
* *
@ -879,8 +852,7 @@ declare namespace Deno {
*/ */
export function hostname(): string; export function hostname(): string;
/** **UNSTABLE**: New API, yet to be vetted. /** A custom HttpClient for use with `fetch`.
* A custom HttpClient for use with `fetch`.
* *
* ```ts * ```ts
* const caCert = await Deno.readTextFile("./ca.pem"); * const caCert = await Deno.readTextFile("./ca.pem");
@ -895,8 +867,7 @@ declare namespace Deno {
close(): void; close(): void;
} }
/** **UNSTABLE**: New API, yet to be vetted. /** The options used when creating a [HttpClient].
* The options used when creating a [HttpClient].
* *
* @category Fetch API * @category Fetch API
*/ */
@ -926,8 +897,7 @@ declare namespace Deno {
password: string; password: string;
} }
/** **UNSTABLE**: New API, yet to be vetted. /** Create a custom HttpClient for to use with `fetch`.
* Create a custom HttpClient for to use with `fetch`.
* *
* ```ts * ```ts
* const caCert = await Deno.readTextFile("./ca.pem"); * const caCert = await Deno.readTextFile("./ca.pem");
@ -946,7 +916,7 @@ declare namespace Deno {
options: CreateHttpClientOptions, options: CreateHttpClientOptions,
): HttpClient; ): HttpClient;
/** **UNSTABLE**: needs investigation into high precision time. /** Needs investigation into high precision time.
* *
* Synchronously changes the access (`atime`) and modification (`mtime`) times * Synchronously changes the access (`atime`) and modification (`mtime`) times
* of a file stream resource referenced by `rid`. Given times are either in * of a file stream resource referenced by `rid`. Given times are either in
@ -965,7 +935,7 @@ declare namespace Deno {
mtime: number | Date, mtime: number | Date,
): void; ): void;
/** **UNSTABLE**: needs investigation into high precision time. /** Needs investigation into high precision time.
* *
* Changes the access (`atime`) and modification (`mtime`) times of a file * Changes the access (`atime`) and modification (`mtime`) times of a file
* stream resource referenced by `rid`. Given times are either in seconds * stream resource referenced by `rid`. Given times are either in seconds
@ -984,24 +954,16 @@ declare namespace Deno {
mtime: number | Date, mtime: number | Date,
): Promise<void>; ): Promise<void>;
/** **UNSTABLE**: new API, yet to be vetted. /** A generic transport listener for message-oriented protocols.
*
* A generic transport listener for message-oriented protocols.
* *
* @category Network * @category Network
*/ */
export interface DatagramConn extends AsyncIterable<[Uint8Array, Addr]> { export interface DatagramConn extends AsyncIterable<[Uint8Array, Addr]> {
/** **UNSTABLE**: new API, yet to be vetted. /** Waits for and resolves to the next message to the `UDPConn`. */
*
* Waits for and resolves to the next message to the `UDPConn`. */
receive(p?: Uint8Array): Promise<[Uint8Array, Addr]>; receive(p?: Uint8Array): Promise<[Uint8Array, Addr]>;
/** UNSTABLE: new API, yet to be vetted. /** Sends a message to the target. */
*
* Sends a message to the target. */
send(p: Uint8Array, addr: Addr): Promise<number>; send(p: Uint8Array, addr: Addr): Promise<number>;
/** UNSTABLE: new API, yet to be vetted. /** Close closes the socket. Any pending message promises will be rejected
*
* Close closes the socket. Any pending message promises will be rejected
* with errors. */ * with errors. */
close(): void; close(): void;
/** Return the address of the `UDPConn`. */ /** Return the address of the `UDPConn`. */
@ -1015,8 +977,7 @@ declare namespace Deno {
path: string; path: string;
} }
/** **UNSTABLE**: new API, yet to be vetted. /**
*
* Listen announces on the local transport address. * Listen announces on the local transport address.
* *
* ```ts * ```ts
@ -1032,9 +993,7 @@ declare namespace Deno {
options: UnixListenOptions & { transport: "unix" }, options: UnixListenOptions & { transport: "unix" },
): Listener; ): Listener;
/** **UNSTABLE**: new API, yet to be vetted /** Listen announces on the local transport address.
*
* Listen announces on the local transport address.
* *
* ```ts * ```ts
* const listener1 = Deno.listenDatagram({ * const listener1 = Deno.listenDatagram({
@ -1057,9 +1016,7 @@ declare namespace Deno {
options: ListenOptions & { transport: "udp" }, options: ListenOptions & { transport: "udp" },
): DatagramConn; ): DatagramConn;
/** **UNSTABLE**: new API, yet to be vetted /** Listen announces on the local transport address.
*
* Listen announces on the local transport address.
* *
* ```ts * ```ts
* const listener = Deno.listenDatagram({ * const listener = Deno.listenDatagram({
@ -1083,8 +1040,7 @@ declare namespace Deno {
path: string; path: string;
} }
/** **UNSTABLE**: The unix socket transport is unstable as a new API yet to /** The TCP transport is considered stable.
* be vetted. The TCP transport is considered stable.
* *
* Connects to the hostname (default is "127.0.0.1") and port on the named * Connects to the hostname (default is "127.0.0.1") and port on the named
* transport (default is "tcp"), and resolves to the connection (`Conn`). * transport (default is "tcp"), and resolves to the connection (`Conn`).
@ -1115,9 +1071,7 @@ declare namespace Deno {
certChain?: string; certChain?: string;
/** PEM formatted (RSA or PKCS8) private key of client certificate. */ /** PEM formatted (RSA or PKCS8) private key of client certificate. */
privateKey?: string; privateKey?: string;
/** **UNSTABLE**: new API, yet to be vetted. /** Application-Layer Protocol Negotiation (ALPN) protocols supported by
*
* Application-Layer Protocol Negotiation (ALPN) protocols supported by
* the client. If not specified, no ALPN extension will be included in the * the client. If not specified, no ALPN extension will be included in the
* TLS handshake. * TLS handshake.
*/ */
@ -1126,9 +1080,7 @@ declare namespace Deno {
/** @category Network */ /** @category Network */
export interface TlsHandshakeInfo { export interface TlsHandshakeInfo {
/** **UNSTABLE**: new API, yet to be vetted. /** Contains the ALPN protocol selected during negotiation with the server.
*
* Contains the ALPN protocol selected during negotiation with the server.
* If no ALPN protocol selected, returns `null`. * If no ALPN protocol selected, returns `null`.
*/ */
alpnProtocol: string | null; alpnProtocol: string | null;
@ -1142,9 +1094,7 @@ declare namespace Deno {
handshake(): Promise<TlsHandshakeInfo>; handshake(): Promise<TlsHandshakeInfo>;
} }
/** **UNSTABLE** New API, yet to be vetted. /** Create a TLS connection with an attached client certificate.
*
* Create a TLS connection with an attached client certificate.
* *
* ```ts * ```ts
* const conn = await Deno.connectTls({ * const conn = await Deno.connectTls({
@ -1164,9 +1114,7 @@ declare namespace Deno {
/** @category Network */ /** @category Network */
export interface ListenTlsOptions { export interface ListenTlsOptions {
/** **UNSTABLE**: new API, yet to be vetted. /** Application-Layer Protocol Negotiation (ALPN) protocols to announce to
*
* Application-Layer Protocol Negotiation (ALPN) protocols to announce to
* the client. If not specified, no ALPN extension will be included in the * the client. If not specified, no ALPN extension will be included in the
* TLS handshake. * TLS handshake.
*/ */
@ -1175,9 +1123,7 @@ declare namespace Deno {
/** @category Network */ /** @category Network */
export interface StartTlsOptions { export interface StartTlsOptions {
/** **UNSTABLE**: new API, yet to be vetted. /** Application-Layer Protocol Negotiation (ALPN) protocols to announce to
*
* Application-Layer Protocol Negotiation (ALPN) protocols to announce to
* the client. If not specified, no ALPN extension will be included in the * the client. If not specified, no ALPN extension will be included in the
* TLS handshake. * TLS handshake.
*/ */
@ -1186,66 +1132,49 @@ declare namespace Deno {
/** @category Network */ /** @category Network */
export interface Listener extends AsyncIterable<Conn> { export interface Listener extends AsyncIterable<Conn> {
/** **UNSTABLE**: new API, yet to be vetted. /** Make the listener block the event loop from finishing.
*
* Make the listener block the event loop from finishing.
* *
* Note: the listener blocks the event loop from finishing by default. * Note: the listener blocks the event loop from finishing by default.
* This method is only meaningful after `.unref()` is called. * This method is only meaningful after `.unref()` is called.
*/ */
ref(): void; ref(): void;
/** **UNSTABLE**: new API, yet to be vetted. /** Make the listener not block the event loop from finishing. */
*
* Make the listener not block the event loop from finishing.
*/
unref(): void; unref(): void;
} }
/** **UNSTABLE**: New API should be tested first. /** Acquire an advisory file-system lock for the provided file. `exclusive`
*
* Acquire an advisory file-system lock for the provided file. `exclusive`
* defaults to `false`. * defaults to `false`.
* *
* @category File System * @category File System
*/ */
export function flock(rid: number, exclusive?: boolean): Promise<void>; export function flock(rid: number, exclusive?: boolean): Promise<void>;
/** **UNSTABLE**: New API should be tested first. /** Acquire an advisory file-system lock for the provided file. `exclusive`
*
* Acquire an advisory file-system lock for the provided file. `exclusive`
* defaults to `false`. * defaults to `false`.
* *
* @category File System * @category File System
*/ */
export function flockSync(rid: number, exclusive?: boolean): void; export function flockSync(rid: number, exclusive?: boolean): void;
/** **UNSTABLE**: New API should be tested first. /** Release an advisory file-system lock for the provided file.
*
* Release an advisory file-system lock for the provided file.
* *
* @category File System * @category File System
*/ */
export function funlock(rid: number): Promise<void>; export function funlock(rid: number): Promise<void>;
/** **UNSTABLE**: New API should be tested first. /** Release an advisory file-system lock for the provided file.
*
* Release an advisory file-system lock for the provided file.
* *
* @category File System * @category File System
*/ */
export function funlockSync(rid: number): void; export function funlockSync(rid: number): void;
/** **UNSTABLE**: new API, yet to be vetted. /** Make the timer of the given id blocking the event loop from finishing.
*
* Make the timer of the given id blocking the event loop from finishing.
* *
* @category Timers * @category Timers
*/ */
export function refTimer(id: number): void; export function refTimer(id: number): void;
/** **UNSTABLE**: new API, yet to be vetted. /** Make the timer of the given id not blocking the event loop from finishing.
*
* Make the timer of the given id not blocking the event loop from finishing.
* *
* @category Timers * @category Timers
*/ */
@ -1295,9 +1224,7 @@ declare namespace Deno {
handler: ServeHandler; handler: ServeHandler;
} }
/** **UNSTABLE**: new API, yet to be vetted. /** Serves HTTP requests with the given handler.
*
* Serves HTTP requests with the given handler.
* *
* You can specify an object with a port and hostname option, which is the * You can specify an object with a port and hostname option, which is the
* address to listen on. The default is port 9000 on hostname "127.0.0.1". * address to listen on. The default is port 9000 on hostname "127.0.0.1".
@ -1366,9 +1293,7 @@ declare namespace Deno {
options: ServeInit & (ServeOptions | ServeTlsOptions), options: ServeInit & (ServeOptions | ServeTlsOptions),
): Promise<void>; ): Promise<void>;
/** **UNSTABLE**: new API, yet to be vetted. /** Allows "hijacking" the connection that the request is associated with.
*
* Allows "hijacking" the connection that the request is associated with.
* This can be used to implement protocols that build on top of HTTP (eg. * This can be used to implement protocols that build on top of HTTP (eg.
* WebSockets). * WebSockets).
* *
@ -1394,9 +1319,7 @@ declare namespace Deno {
request: Request, request: Request,
): Promise<[Deno.Conn, Uint8Array]>; ): Promise<[Deno.Conn, Uint8Array]>;
/** **UNSTABLE**: new API, yet to be vetted. /** Allows "hijacking" the connection that the request is associated with.
*
* Allows "hijacking" the connection that the request is associated with.
* This can be used to implement protocols that build on top of HTTP (eg. * This can be used to implement protocols that build on top of HTTP (eg.
* WebSockets). * WebSockets).
@ -1581,9 +1504,7 @@ declare function fetch(
/** @category Web Workers */ /** @category Web Workers */
declare interface WorkerOptions { declare interface WorkerOptions {
/** UNSTABLE: New API. /** Configure permissions options to change the level of access the worker will
*
* Configure permissions options to change the level of access the worker will
* have. By default it will have no permissions. Note that the permissions * have. By default it will have no permissions. Note that the permissions
* of a worker can't be extended beyond its parent's permissions reach. * of a worker can't be extended beyond its parent's permissions reach.
* - "inherit" will take the permissions of the thread the worker is created in * - "inherit" will take the permissions of the thread the worker is created in