Pustaka klien Azure Core LRO untuk JavaScript - versi 3.2.0

Ini adalah implementasi default dari operasi jangka panjang di pustaka klien JavaScript Azure SDK yang berfungsi di browser dan NodeJS. Pustaka ini terutama dimaksudkan untuk digunakan dalam kode yang dihasilkan oleh AutoRest dan autorest.typescript.

@azure/core-lro mengikuti Panduan Desain Azure SDK untuk Operasi Jangka Panjang

Tautan kunci:

• Kode sumber
• Paket (npm)
• Dokumentasi Referensi API
• Sampel

Memulai Langkah Pertama

Lingkungan yang didukung saat ini

• Versi LTS dari Node.js
• Versi terbaru Safari, Chrome, Edge, dan Firefox.

Instalasi

Paket ini terutama digunakan dalam kode yang dihasilkan dan tidak dimaksudkan untuk digunakan langsung oleh pengguna akhir.

Konsep utama

SimplePollerLike

Poller adalah objek yang dapat melakukan polling operasi jangka panjang di server untuk statusnya sampai mencapai status terminal. Ini menyediakan metode berikut:

• getOperationState: mengembalikan status operasi, dititik sebagai jenis yang diperluas OperationState
• getResult: mengembalikan hasil operasi ketika selesai dan undefined sebaliknya
• isDone: mengembalikan apakah operasi dalam status terminal
• isStopped: mengembalikan apakah polling berhenti
• onProgress: mendaftarkan fungsi panggilan balik yang akan dipanggil setiap kali respons polling diterima
• poll: mengirimkan satu permintaan polling
• pollUntilDone: mengembalikan janji yang akan diselesaikan dengan hasil operasi
• stopPolling: menghentikan polling;
• toString: menserialisasikan status poller

OperationState

Jenis untuk status operasi. Ini berisi status bidang dengan kemungkinan nilai berikut: notStarted, , running, succeededfailed, dan canceled. Ini dapat diakses sebagai berikut:

switch (poller.operationState.status) {
  case "succeeded": // return poller.getResult();
  case "failed": // throw poller.getOperationState().error;
  case "canceled": // throw new Error("Operation was canceled");
  case "running": // ...
  case "notStarted": // ...
}

createHttpPoller

Fungsi yang mengembalikan objek jenis SimplePollerLike. Polling ini berulah sebagai berikut jika terjadi kesalahan:

• panggilan ke poll dan pollUntilDone akan melemparkan kesalahan jika operasi gagal atau dibatalkan kecuali resolveOnUnsuccessful opsi diatur ke true.
• poller.getOperationState().status akan diatur ke true ketika operasi gagal atau mengembalikan respons kesalahan.

Contoh

Contoh dapat ditemukan di folder samples.

Pemecahan masalah

Penebangan kayu

Log dapat ditambahkan atas kebijakan pustaka yang mengimplementasikan poller Operasi Jangka Panjang. Paket di dalam azure-sdk-for-js menggunakan @azure/pencatat.

Langkah berikutnya

Silakan lihat sampel direktori untuk contoh terperinci tentang cara menggunakan pustaka ini.

Kontribusi

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

Uji coba

Untuk menjalankan pengujian kami, pertama-tama instal dependensi (dengan npm install atau rush install), lalu jalankan pengujian unit dengan: npm run unit-test.

Kode Etik

Proyek ini telah mengadopsi Kode Etik Sumber Terbuka Microsoft. Untuk informasi selengkapnya, lihat Tanya Jawab Umum Kode Etik atau hubungi opencode@microsoft.com dengan pertanyaan atau komentar tambahan apa pun.