You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
117 lines
5.4 KiB
117 lines
5.4 KiB
/** |
|
* **The version of the punycode module bundled in Node.js is being deprecated.**In a future major version of Node.js this module will be removed. Users |
|
* currently depending on the `punycode` module should switch to using the |
|
* userland-provided [Punycode.js](https://github.com/bestiejs/punycode.js) module instead. For punycode-based URL |
|
* encoding, see `url.domainToASCII` or, more generally, the `WHATWG URL API`. |
|
* |
|
* The `punycode` module is a bundled version of the [Punycode.js](https://github.com/bestiejs/punycode.js) module. It |
|
* can be accessed using: |
|
* |
|
* ```js |
|
* const punycode = require('punycode'); |
|
* ``` |
|
* |
|
* [Punycode](https://tools.ietf.org/html/rfc3492) is a character encoding scheme defined by RFC 3492 that is |
|
* primarily intended for use in Internationalized Domain Names. Because host |
|
* names in URLs are limited to ASCII characters only, Domain Names that contain |
|
* non-ASCII characters must be converted into ASCII using the Punycode scheme. |
|
* For instance, the Japanese character that translates into the English word,`'example'` is `'例'`. The Internationalized Domain Name, `'例.com'` (equivalent |
|
* to `'example.com'`) is represented by Punycode as the ASCII string`'xn--fsq.com'`. |
|
* |
|
* The `punycode` module provides a simple implementation of the Punycode standard. |
|
* |
|
* The `punycode` module is a third-party dependency used by Node.js and |
|
* made available to developers as a convenience. Fixes or other modifications to |
|
* the module must be directed to the [Punycode.js](https://github.com/bestiejs/punycode.js) project. |
|
* @deprecated Since v7.0.0 - Deprecated |
|
* @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/punycode.js) |
|
*/ |
|
declare module 'punycode' { |
|
/** |
|
* The `punycode.decode()` method converts a [Punycode](https://tools.ietf.org/html/rfc3492) string of ASCII-only |
|
* characters to the equivalent string of Unicode codepoints. |
|
* |
|
* ```js |
|
* punycode.decode('maana-pta'); // 'mañana' |
|
* punycode.decode('--dqo34k'); // '☃-⌘' |
|
* ``` |
|
* @since v0.5.1 |
|
*/ |
|
function decode(string: string): string; |
|
/** |
|
* The `punycode.encode()` method converts a string of Unicode codepoints to a [Punycode](https://tools.ietf.org/html/rfc3492) string of ASCII-only characters. |
|
* |
|
* ```js |
|
* punycode.encode('mañana'); // 'maana-pta' |
|
* punycode.encode('☃-⌘'); // '--dqo34k' |
|
* ``` |
|
* @since v0.5.1 |
|
*/ |
|
function encode(string: string): string; |
|
/** |
|
* The `punycode.toUnicode()` method converts a string representing a domain name |
|
* containing [Punycode](https://tools.ietf.org/html/rfc3492) encoded characters into Unicode. Only the [Punycode](https://tools.ietf.org/html/rfc3492) encoded parts of the domain name are be |
|
* converted. |
|
* |
|
* ```js |
|
* // decode domain names |
|
* punycode.toUnicode('xn--maana-pta.com'); // 'mañana.com' |
|
* punycode.toUnicode('xn----dqo34k.com'); // '☃-⌘.com' |
|
* punycode.toUnicode('example.com'); // 'example.com' |
|
* ``` |
|
* @since v0.6.1 |
|
*/ |
|
function toUnicode(domain: string): string; |
|
/** |
|
* The `punycode.toASCII()` method converts a Unicode string representing an |
|
* Internationalized Domain Name to [Punycode](https://tools.ietf.org/html/rfc3492). Only the non-ASCII parts of the |
|
* domain name will be converted. Calling `punycode.toASCII()` on a string that |
|
* already only contains ASCII characters will have no effect. |
|
* |
|
* ```js |
|
* // encode domain names |
|
* punycode.toASCII('mañana.com'); // 'xn--maana-pta.com' |
|
* punycode.toASCII('☃-⌘.com'); // 'xn----dqo34k.com' |
|
* punycode.toASCII('example.com'); // 'example.com' |
|
* ``` |
|
* @since v0.6.1 |
|
*/ |
|
function toASCII(domain: string): string; |
|
/** |
|
* @deprecated since v7.0.0 |
|
* The version of the punycode module bundled in Node.js is being deprecated. |
|
* In a future major version of Node.js this module will be removed. |
|
* Users currently depending on the punycode module should switch to using |
|
* the userland-provided Punycode.js module instead. |
|
*/ |
|
const ucs2: ucs2; |
|
interface ucs2 { |
|
/** |
|
* @deprecated since v7.0.0 |
|
* The version of the punycode module bundled in Node.js is being deprecated. |
|
* In a future major version of Node.js this module will be removed. |
|
* Users currently depending on the punycode module should switch to using |
|
* the userland-provided Punycode.js module instead. |
|
*/ |
|
decode(string: string): number[]; |
|
/** |
|
* @deprecated since v7.0.0 |
|
* The version of the punycode module bundled in Node.js is being deprecated. |
|
* In a future major version of Node.js this module will be removed. |
|
* Users currently depending on the punycode module should switch to using |
|
* the userland-provided Punycode.js module instead. |
|
*/ |
|
encode(codePoints: ReadonlyArray<number>): string; |
|
} |
|
/** |
|
* @deprecated since v7.0.0 |
|
* The version of the punycode module bundled in Node.js is being deprecated. |
|
* In a future major version of Node.js this module will be removed. |
|
* Users currently depending on the punycode module should switch to using |
|
* the userland-provided Punycode.js module instead. |
|
*/ |
|
const version: string; |
|
} |
|
declare module 'node:punycode' { |
|
export * from 'punycode'; |
|
}
|
|
|