@azure/core-lro
Advanced tools
Package description
The @azure/core-lro package provides a framework for building and working with long-running operations (LROs) in Azure services. It offers a standardized way to poll for the status of these operations and retrieve the final results, abstracting the complexity involved in handling LROs.
Creating and managing long-running operations
This feature allows developers to implement custom pollers for managing long-running operations. The code sample demonstrates how to extend the Poller class to create a custom LRO poller.
const { Poller } = require('@azure/core-lro');
class MyLroPoller extends Poller {
async cancelOperation() {
// Cancel the operation if supported
}
async delay() {
// Implement delay between polls
}
}
const myPoller = new MyLroPoller();
await myPoller.pollUntilDone();Polling for operation status
This feature enables polling for the status of a long-running operation until it is completed. The code sample shows how to use the Poller class to poll an operation until it's done.
const { Poller } = require('@azure/core-lro');
async function pollOperation(operation) {
const poller = new Poller({
operation,
});
return await poller.pollUntilDone();
}The 'async' package provides utilities for working with asynchronous JavaScript, including control flow, iteration, and utilities functions. While it doesn't specifically target long-running operations, it offers tools that could be used to manage asynchronous tasks and operations, which could indirectly support LRO scenarios. However, it lacks the direct LRO management and polling capabilities of @azure/core-lro.
RxJS is a library for reactive programming using Observables, to make it easier to compose asynchronous or callback-based code. This can be particularly useful for managing streams of events or asynchronous tasks, which could include long-running operations. However, RxJS does not provide specific abstractions for LROs like @azure/core-lro does, focusing instead on a broader set of reactive programming tools.
Readme
This is the default implementation of long running operations in Azure SDK JavaScript client libraries which work in both the browser and NodeJS. This library is primarily intended to be used in code generated by AutoRest and autorest.typescript.
@azure/core-lro follows The Azure SDK Design Guidelines for Long Running Operations
Key links:
This package is primarily used in generated code and not meant to be consumed directly by end users.
SimplePollerLikeA poller is an object that can poll the long running operation on the server for its state until it reaches a terminal state. It provides the following methods:
getOperationState: returns the state of the operation, typed as a type that extends OperationStategetResult: returns the result of the operation when it completes and undefined otherwiseisDone: returns whether the operation is in a terminal stateisStopped: returns whether the polling stoppedonProgress: registers callback functions to be called every time a polling response is receivedpoll: sends a single polling requestpollUntilDone: returns a promise that will resolve with the result of the operationstopPolling: stops polling;toString: serializes the state of the pollerOperationStateA type for the operation state. It contains a status field with the following possible values: notStarted, running, succeeded, failed, and canceled. It can be accessed as follows:
switch(poller.getOperationState().status) {
case "succeeded": // return poller.getResult();
case "failed": // throw poller.getOperationState().error;
case "canceled": // throw new Error("Operation was canceled");
case "running": // ...
case "notStarted": // ...
}
createHttpPollerA function that returns an object of type SimplePollerLike. This poller behaves as follows in the presence of errors:
poll and pollUntilDone will throw an error in case the operation has failed or canceled unless the resolveOnUnsuccessful option was set to true.poller.getOperationState().status will be set to true when either the operation fails or it returns an error response.Examples can be found in the samples folder.
Logs can be added at the discretion of the library implementing the Long Running Operation poller. Packages inside of azure-sdk-for-js use @azure/logger.
Please take a look at the samples directory for detailed examples on how to use this library.
If you'd like to contribute to this library, please read the contributing guide to learn more about how to build and test the code.
To run our tests, first install the dependencies (with npm install or rush install),
then run the unit tests with: npm run unit-test.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
FAQs
Isomorphic client library for supporting long-running operations in node.js and browser.
The npm package @azure/core-lro receives a total of 2,525,010 weekly downloads. As such, @azure/core-lro popularity was classified as popular.
We found that @azure/core-lro demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.
Security News
GitHub is susceptible to a CDN flaw that allows attackers to host malware on any public repository.