Dela via

Azure Core LRO-klientbibliotek för JavaScript – version 3.3.1

Detta är standardimplementeringen av tidskrävande åtgärder i Azure SDK JavaScript-klientbibliotek som fungerar i både webbläsaren och NodeJS. Det här biblioteket är främst avsett att användas i kod som genereras av AutoRest och autorest.typescript.

@azure/core-lro följer Azure SDK:s designriktlinjer för tidskrävande åtgärder

Nyckellänkar:

Komma igång

Miljöer som stöds för närvarande

Installation

Det här paketet används främst i genererad kod och är inte avsett att användas direkt av slutanvändare.

Viktiga begrepp

SimplePollerLike

En poller är ett objekt som kan avsöka den tidskrävande åtgärden på servern för dess tillstånd tills den når ett terminaltillstånd. Den innehåller följande metoder:

  • getOperationState: returnerar tillståndet för åtgärden, skrivet som en typ som utökar OperationState
  • getResult: returnerar resultatet av åtgärden när den har slutförts och undefined annars
  • isDone: returnerar om åtgärden är i ett terminaltillstånd
  • isStopped: returnerar om avsökningen stoppades
  • onProgress: registrerar återanropsfunktioner som ska anropas varje gång ett avsökningssvar tas emot
  • poll: skickar en enda avsökningsbegäran
  • pollUntilDone: returnerar ett löfte som kommer att lösas med resultatet av åtgärden
  • stopPolling: stoppar avsökning;
  • toString: serialiserar pollerens tillstånd

OperationState

En typ för åtgärdstillståndet. Det innehåller ett status fält med följande möjliga värden: notStarted, running, succeeded, failed, och canceled. Den kan nås på följande sätt:

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

En funktion som returnerar ett objekt av typen SimplePollerLike. Den här pollern beter sig så här i närvaro av fel:

  • anropar till poll och pollUntilDone utlöser ett fel om åtgärden har misslyckats eller avbrutits såvida inte resolveOnUnsuccessful alternativet har angetts till sant.
  • poller.getOperationState().status anges till true när åtgärden misslyckas eller returnerar ett felsvar.

Exempel

Exempel finns i mappen samples.

Felsökning

Loggning / Skogsavverkning

Loggar kan läggas till efter eget gottfinnande för biblioteket som implementerar den tidskrävande åtgärden poller. Paket i azure-sdk-for-js använder @azure/logger.

Nästa steg

Ta en titt på exempel katalog för detaljerade exempel på hur du använder det här biblioteket.

Bidrag

Om du vill bidra till det här biblioteket kan du läsa bidragsguide för att lära dig mer om hur du skapar och testar koden.

Testa

Om du vill köra våra tester installerar du först beroendena (med pnpm install) och kör sedan enhetstesterna med: npm run unit-test.

Uppförandekod

Det här projektet har antagit Microsoft Open Source Code of Conduct. Mer information finns i vanliga frågor och svar om uppförandekod eller kontakta opencode@microsoft.com med ytterligare frågor eller kommentarer.