Azure / Azure/azure-functions-nodejs-library

Reduce confusion for "magic" binding expressions

Aperta
#167 1 commento 3 reazioni 0 assegnatari Vedi su GitHub
area:nodejs-functions enhancement P2
Lingua principale
TypeScript
Stelle
70
Fork
35
Merge medio
4g 18h
PR unite (30g)
6

Descrizione

We've had several people get confused by these (example [1](https://github.com/Azure/azure-functions-nodejs-library/issues/103), [2](https://github.com/Azure/azure-functions-nodejs-library/issues/84), [3](https://github.com/Azure/azure-functions-nodejs-library/discussions/152#discussioncomment-7209198)). I think the main problem is that these are hard-coded string values that basically perform magic under the covers and the documentation is hard-to-find. Would be nice if we could add some Intellisense or helper methods to make it easier to understand.

Example [binding expression](https://learn.microsoft.com/en-us/azure/azure-functions/functions-bindings-expressions-patterns):
```typescript
const blobOutput = output.storageBlob({
connection: "AzureWebJobsStorage",
path: "helloworld/{DateTime:MM-dd-yyyy H:mm:ss}.json",
});
```

Example [route parameter](https://learn.microsoft.com/en-us/azure/azure-functions/functions-bindings-http-webhook-trigger?pivots=programming-language-javascript#using-route-parameters):
```typescript
app.http('httpTrigger1', {
methods: ['GET', 'POST'],
authLevel: 'anonymous',
route: 'httpTrigger1/{id}',
handler: httpTrigger1
});
```

Guida per i contributori

Apri la guida per i contributori

Direzione di ricerca

Inizia esaminando le API output.storageBlob e app.http, insieme alla documentazione collegata su binding-expression e route-parameter e alle issue correlate. Definisci se l’obiettivo è IntelliSense, metodi helper o entrambi, quindi conferma che l’API risultante renda individuabili le espressioni di binding e i parametri di route senza dipendere da stringhe hard-coded.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
azure, typescript
Ambito
backend-api-design, developer-experience
Tipo di issue
Funzionalità
Difficoltà
5/5
Tempo stimato
Più di una settimana
Stato di attività
Ferma
Chiarezza
Abbastanza chiara
Idoneità per principianti
35/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.