Come leggere il suggerimento sintassi di intellisense del codice di studio visivo, qualsiasi documento per gli operatori? - node.js, visual-studio

VSC come VS emette sintassi di sintassi / firma. Capisco : significa tipo di dati

myText: string  // : means datatype of myText is string
myStuff: any    // any means can be any data type.

a volte difficile indovinare cosa significano gli operatori, ad esempio la richiesta del Nodo (),

la mia comprensione è

1. const request significa che posso definire qualsiasi variabile come const x=request(...) o var x=request(...).
2. request.RequestAPI significa che è una chiamata API.
3. options: definisce questo parametro è un tipico tipo di opzioni in forma di {...}
4. (request.UriOptions & request.CoreOptions) Capisco le parti di inizio e fine, devono essere enum di Uri e Core, ma cos'è &? Significa che ho bisogno di fornire sia Uri E Nucleo?
5. | significa questo tubo O? Se è così sta duplicando la parte prima della pipa.
6. callback?: request.RequestCallback, quindi qui devo fornire un callback che verrà digitato (o funzionante) come RequestCallback, ma che cos'è ?:?

C'è qualche documento per queste convenzioni?

risposte:

Volevo commentare perché non conosco la risposta completa, ma ecco alcune informazioni utili:

Probabilmente stai vedendo questa definizione di DefinitelyTyped: https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/request/index.d.ts#L29

Dai un'occhiata a questo per capire la sintassi del file di definizione: http://www.typescriptlang.org/docs/handbook/declaration-files/by-example.html

E tu puoi interpretare la definizione in questo modo:

const request: c'è una costante chiamata richiesta che implementa l'interfaccia request.RequestAPI (che è anche richiamabile direttamente e quindi per quello) prende argomenti options di tipo (request.UriOptions & request.CoreOptions) | (request.UrlOptions & request.CoreOptions) e un parametro opzionale callback (quindi il ? di tipo request.RequestCallback. La funzione restituisce a request.Request.

• & di solito significa e
• Una pipa | di solito significa o, non c'è nessuna duplicazione URI vs URL
• => "ritorna"
• Vedi request di fronte a tutto perché è lo spazio dei nomi (la mia formulazione potrebbe essere qui)

Le definizioni di UriOptions, UrlOptions, CoreOptions sono sepolto un po '. Non sono un utente del nodo, quindi non so cosa è possibile passare alla richiesta. Per esempio UrlOptions può essere un argomento stringa chiamato "url" o a url (a partire dal require("url")). Vedere https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/request/index.d.ts#L162