Azure Template-clientbibliotheek voor JavaScript - versie 1.0.0-beta.1
Dit project wordt gebruikt als een sjabloonpakket voor de Azure SDK voor JavaScript. Het is bedoeld om Azure SDK-ontwikkelaars te helpen bij het opstarten van nieuwe pakketten en biedt een voorbeeld van het organiseren van de code en documentatie van een clientbibliotheek voor een Azure-service.
Aan de slag
Momenteel ondersteunde omgevingen
- LTS-versies van Node.js
- Nieuwste versies van Safari, Chrome, Edge en Firefox.
Zie ons ondersteuningsbeleid voor meer informatie.
Vereisten
- Een Azure-abonnement.
Meestal plaatst u hier een shell-opdracht voor het inrichten van de benodigde Azure-services.
Installeer het pakket @azure/template
Installeer de sjabloonclientbibliotheek voor JavaScript met npm
:
npm install @azure/template
Browserondersteuning
JavaScript-bundel
Als u deze clientbibliotheek in de browser wilt gebruiken, moet u eerst een bundelaar gebruiken. Raadpleeg onze documentatie voor bundeling voor meer informatie over hoe u dit doet.
CORS
U moet CORS-regels (Cross-Origin Resource Sharing) instellen voor uw opslagaccount als u wilt ontwikkelen voor browsers. Ga naar Azure Portal en Azure Storage Explorer, zoek uw opslagaccount en maak nieuwe CORS-regels voor blob/queue/file/table-service(s).
U kunt bijvoorbeeld de volgende CORS-instellingen voor foutopsporing maken. Maar pas de instellingen zorgvuldig aan op basis van uw vereisten in een productieomgeving.
- Toegestane oorsprongen: *
- Toegestane werkwoorden: DELETE,GET,HEAD,MERGE,POST,OPTIONS,PUT
- Toegestane headers: *
- Weergegeven headers: *
- Maximale leeftijd (seconden): 86400
Meer voorbeelden
Voorbeelden op het hoogste niveau zijn meestal zaken als het maken en verifiëren van de hoofdclient. Als uw service meerdere verificatiemiddelen ondersteunt (bijvoorbeeld op basis van sleutels en Azure Active Directory), kunt u hiervan een afzonderlijk voorbeeld geven.
Belangrijkste concepten
ConfigurationClient
Beschrijf hier uw primaire client. Praat over welke bewerkingen kunnen worden uitgevoerd en wanneer een ontwikkelaar deze zou willen gebruiken.
Aanvullende voorbeelden
Maak een sectie voor elk serviceconcept op het hoogste niveau dat u wilt uitleggen.
Voorbeelden
Eerste voorbeeld
Maak verschillende codevoorbeelden voor hoe iemand uw bibliotheek zou gebruiken om een algemene taak met de service uit te voeren.
Problemen oplossen
Logboekregistratie
Het inschakelen van logboekregistratie kan helpen bij het ontdekken van nuttige informatie over fouten. Als u een logboek met HTTP-aanvragen en -antwoorden wilt zien, stelt u de AZURE_LOG_LEVEL
omgevingsvariabele in op info
. Logboekregistratie kan ook worden ingeschakeld tijdens runtime door aan te roepen setLogLevel
in de @azure/logger
:
const { setLogLevel } = require("@azure/logger");
setLogLevel("info");
Voor meer gedetailleerde instructies over het inschakelen van logboeken kunt u de @azure-/loggerpakketdocumenten bekijken.
Volgende stappen
Raadpleeg de map met voorbeelden voor gedetailleerde voorbeelden die laten zien hoe u de clientbibliotheken gebruikt.
Bijdragen
Als u een bijdrage wilt leveren aan deze bibliotheek, leest u de handleiding voor bijdragen voor meer informatie over het bouwen en testen van de code.
Verwante projecten
Azure SDK for JavaScript