Bagikan melalui


Pustaka klien Templat Azure untuk JavaScript - versi 1.0.0-beta.1

Proyek ini digunakan sebagai paket templat untuk Azure SDK untuk JavaScript. Ini dimaksudkan untuk membantu pengembang Azure SDK bootstrap paket baru, dan memberikan contoh cara mengatur kode dan dokumentasi pustaka klien untuk layanan Azure.

Memulai

Lingkungan yang didukung saat ini

Lihat kebijakan dukungan kami untuk detail selengkapnya.

Prasyarat

Biasanya Anda akan menempatkan perintah shell untuk menyediakan layanan Azure yang diperlukan di sini.

Pasang paket @azure/template

Instal pustaka klien Templat untuk JavaScript dengan npm:

npm install @azure/template

Dukungan browser

Bundel JavaScript

Untuk menggunakan pustaka klien ini di browser, pertama-tama Anda perlu menggunakan bunder. Untuk detail tentang cara melakukan ini, silakan lihat dokumentasi bundling kami.

CORS

Anda perlu menyiapkan aturan Berbagi Sumber Daya Lintas Asal (CORS) untuk akun penyimpanan Anda jika Anda perlu mengembangkan browser. Buka portal Azure dan Azure Storage Explorer, temukan akun penyimpanan Anda, buat aturan CORS baru untuk layanan blob/antrean/file/tabel.

Misalnya, Anda dapat membuat pengaturan CORS berikut untuk penelusuran kesalahan. Tetapi harap sesuaikan pengaturan dengan hati-hati sesuai dengan kebutuhan Anda di lingkungan produksi.

  • Asal yang diizinkan: *
  • Kata kerja yang diizinkan: DELETE,GET,HEAD,MERGE,POST,OPTIONS,PUT
  • Header yang diperbolehkan: *
  • Header yang diekspos: *
  • Usia maksimum (detik): 86400

Contoh lebih lanjut

Contoh tingkat atas biasanya mencakup hal-hal seperti membuat dan mengautentikasi Klien utama. Jika layanan Anda mendukung beberapa cara untuk mengautentikasi (misalnya berbasis kunci dan Azure Active Directory), Anda dapat memberikan contoh terpisah dari masing-masing.

Konsep utama

ConfigurationClient

Jelaskan klien utama Anda di sini. Bicara tentang operasi apa yang dapat dilakukannya dan kapan pengembang ingin menggunakannya.

Contoh tambahan

Buat bagian untuk setiap konsep layanan tingkat atas yang ingin Anda jelaskan.

Contoh

Contoh Pertama

Buat beberapa contoh kode tentang bagaimana seseorang akan menggunakan pustaka Anda untuk menyelesaikan tugas umum dengan layanan.

Pemecahan Masalah

Pencatatan

Mengaktifkan pengelogan dapat membantu menemukan informasi yang berguna tentang kegagalan. Untuk melihat log permintaan dan respons HTTP, atur variabel lingkungan AZURE_LOG_LEVEL ke info. Atau, pengelogan dapat diaktifkan saat runtime dengan memanggil setLogLevel di @azure/logger:

const { setLogLevel } = require("@azure/logger");

setLogLevel("info");

Untuk instruksi lebih rinci tentang cara mengaktifkan log, Anda dapat melihat dokumen paket @azure/pencatat.

Langkah berikutnya

Silakan lihat direktori sampel untuk contoh terperinci yang menunjukkan cara menggunakan pustaka klien.

Berkontribusi

Jika Anda ingin berkontribusi pada pustaka ini, baca panduan berkontribusi untuk mempelajari selengkapnya tentang cara membuat dan menguji kode.

Tayangan