@aws-sdk/util-user-agent-node

What is @aws-sdk/util-user-agent-node?

@aws-sdk/util-user-agent-node is a utility package from the AWS SDK for JavaScript. It is used to construct and manage user-agent strings for AWS SDK clients running in Node.js environments. This helps in identifying the SDK version, environment, and other relevant information when making requests to AWS services.

What are @aws-sdk/util-user-agent-node's main functionalities?

Constructing User-Agent String

This feature allows you to construct a default user-agent string that includes information about the SDK version and the runtime environment.

const { defaultUserAgent } = require('@aws-sdk/util-user-agent-node');
const userAgent = defaultUserAgent();
console.log(userAgent);

Customizing User-Agent String

This feature allows you to customize the user-agent string by adding additional information, such as application-specific details.

const { defaultUserAgent } = require('@aws-sdk/util-user-agent-node');
const customUserAgent = defaultUserAgent({ custom: 'myApp/1.0.0' });
console.log(customUserAgent);

Other packages similar to @aws-sdk/util-user-agent-node

useragent

The 'useragent' package is a comprehensive library for parsing user-agent strings in Node.js. It provides detailed information about the browser, operating system, and device. Unlike @aws-sdk/util-user-agent-node, which is focused on constructing user-agent strings for AWS SDK clients, 'useragent' is more general-purpose and can be used in a variety of applications.

ua-parser-js

The 'ua-parser-js' package is a JavaScript library for parsing user-agent strings and extracting detailed information about the browser, engine, OS, CPU, and device. It is similar to 'useragent' but is designed to be lightweight and fast. While @aws-sdk/util-user-agent-node is specialized for AWS SDK clients, 'ua-parser-js' is suitable for broader use cases.

README

@aws-sdk/util-user-agent-node

An internal package

Usage

You probably shouldn't, at least directly.

Changelog

3.662.0 (2024-10-01)

Bug Fixes

• s3-request-presigner: enable overriding hoistable headers (#6535) (3c2e59c)

Features

• client-bedrock-agent: This release adds support to stop an ongoing ingestion job using the StopIngestionJob API in Agents for Amazon Bedrock. (ac89806)
• client-codeartifact: Add support for the dual stack endpoints. (cb499b9)
• client-rds: This release provides additional support for enabling Aurora Limitless Database DB clusters. (b7b061d)
• clients: update client endpoints as of 2024-10-01 (15702eb)