@azure/core-util

What is @azure/core-util?

The @azure/core-util package provides a set of utilities used by Azure SDK for JavaScript packages. These utilities include functions for dealing with delays, tracing, and other common tasks that are useful when interacting with Azure services or building applications that integrate with the Azure ecosystem.

What are @azure/core-util's main functionalities?

delay

Provides a way to pause execution for a specified amount of time. This is useful for implementing retries or waiting for an operation to complete.

async function main() {
  await delay(1000);
  console.log('Delayed for 1 second');
}
main();

trace

Facilitates distributed tracing of operations, allowing for monitoring and diagnosing issues across distributed systems.

const span = createSpan('my-operation', {kind: SpanKind.INTERNAL});
try {
  // operation code here
} finally {
  span.end();
}

Other packages similar to @azure/core-util

lodash

Lodash is a utility library offering a wide array of functions for tasks like data manipulation, testing, and logic operations. While it doesn't focus on Azure or distributed tracing specifically, it provides general-purpose utilities that are useful in many of the same scenarios as @azure/core-util.

async

The async package provides utilities for working with asynchronous JavaScript, such as managing series, parallel, and waterfall control flow. It's similar to @azure/core-util in that it helps manage asynchronous operations, but it doesn't include utilities for tracing or Azure-specific integrations.

README

Azure Core Util client library for JavaScript (Experimental)

This library is intended to provide various shared utility functions for client SDK packages.

Getting started

Requirements

Currently supported environments

• LTS versions of Node.js
• Latest versions of Safari, Chrome, Edge, and Firefox.

See our support policy for more details.

Installation

This package is primarily used in authoring client SDKs and not meant to be consumed directly by end users.

Key concepts

Utility methods provided by this library should be stateless.

Examples

Examples can be found in the samples folder.

Next steps

Look at usage in dependent client SDKs.

Troubleshooting

If you run into issues while using this library, please feel free to file an issue.

Contributing

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.