Punycode

Deprecato a partire da: v7.0.0

[Stabile: 0 - Deprecato]

Stabile: 0 Stabilità: 0 - Deprecato

Codice sorgente: lib/punycode.js

La versione del modulo punycode inclusa in Node.js è in fase di deprecazione. In una futura versione principale di Node.js questo modulo verrà rimosso. Gli utenti che attualmente dipendono dal modulo punycode dovrebbero passare all'utilizzo del modulo Punycode.js fornito dall'utente. Per la codifica URL basata su punycode, vedi url.domainToASCII o, più in generale, la WHATWG URL API.

Il modulo punycode è una versione in bundle del modulo Punycode.js. È possibile accedervi utilizzando:

const punycode = require('node:punycode');

Punycode è uno schema di codifica dei caratteri definito da RFC 3492 che è principalmente destinato all'uso nei nomi di dominio internazionalizzati. Poiché i nomi host negli URL sono limitati ai soli caratteri ASCII, i nomi di dominio che contengono caratteri non ASCII devono essere convertiti in ASCII utilizzando lo schema Punycode. Ad esempio, il carattere giapponese che si traduce nella parola inglese 'example' è '例'. Il nome di dominio internazionalizzato, '例.com' (equivalente a 'example.com') è rappresentato da Punycode come la stringa ASCII 'xn--fsq.com'.

Il modulo punycode fornisce una semplice implementazione dello standard Punycode.

Il modulo punycode è una dipendenza di terze parti utilizzata da Node.js e messa a disposizione degli sviluppatori per comodità. Correzioni o altre modifiche al modulo devono essere indirizzate al progetto Punycode.js.

punycode.decode(string)

Aggiunto in: v0.5.1

• string <stringa>

Il metodo punycode.decode() converte una stringa Punycode di caratteri solo ASCII nella stringa equivalente di codepoint Unicode.

punycode.decode('maana-pta'); // 'mañana'
punycode.decode('--dqo34k'); // '☃-⌘'

punycode.encode(string)

Aggiunto in: v0.5.1

• string <stringa>

Il metodo punycode.encode() converte una stringa di punti di codice Unicode in una stringa Punycode di soli caratteri ASCII.

punycode.encode('mañana'); // 'maana-pta'
punycode.encode('☃-⌘'); // '--dqo34k'

punycode.toASCII(domain)

Aggiunto in: v0.6.1

• domain <stringa>

Il metodo punycode.toASCII() converte una stringa Unicode che rappresenta un nome di dominio internazionalizzato in Punycode. Saranno convertite solo le parti non ASCII del nome di dominio. Chiamare punycode.toASCII() su una stringa che contiene già solo caratteri ASCII non avrà alcun effetto.

// codifica i nomi di dominio
punycode.toASCII('mañana.com');  // 'xn--maana-pta.com'
punycode.toASCII('☃-⌘.com');   // 'xn----dqo34k.com'
punycode.toASCII('example.com'); // 'example.com'

punycode.toUnicode(domain)

Aggiunto in: v0.6.1

• domain <stringa>

Il metodo punycode.toUnicode() converte una stringa che rappresenta un nome di dominio contenente caratteri codificati Punycode in Unicode. Verranno convertite solo le parti del nome di dominio codificate Punycode.

// decodifica i nomi di dominio
punycode.toUnicode('xn--maana-pta.com'); // 'mañana.com'
punycode.toUnicode('xn----dqo34k.com');  // '☃-⌘.com'
punycode.toUnicode('example.com');       // 'example.com'

punycode.ucs2

Aggiunto in: v0.7.0

punycode.ucs2.decode(string)

Aggiunto in: v0.7.0

• string <stringa>

Il metodo punycode.ucs2.decode() restituisce un array contenente i valori numerici del punto di codice di ciascun simbolo Unicode nella stringa.

punycode.ucs2.decode('abc'); // [0x61, 0x62, 0x63]
// coppia surrogata per l'U+1D306 tetragramma per il centro:
punycode.ucs2.decode('\uD834\uDF06'); // [0x1D306]

punycode.ucs2.encode(codePoints)

Aggiunto in: v0.7.0

• codePoints <integer[]>

Il metodo punycode.ucs2.encode() restituisce una stringa basata su un array di valori numerici del punto di codice.

punycode.ucs2.encode([0x61, 0x62, 0x63]); // 'abc'
punycode.ucs2.encode([0x1D306]); // '\uD834\uDF06'

punycode.version

Aggiunto in: v0.6.1

• <string>

Restituisce una stringa che identifica il numero di versione corrente di Punycode.js.