@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.197.0 (2022-10-26)

Bug Fixes

• endpoint: normalize endpoint to string when passing from client config to endpointParams (#4098) (5da4499)
• smithy-client: fix default error typo (#4092) (e8158a6)
• types: expand custom endpoint type (#4097) (3620ce4)

Features

• client-kafka: This release adds support for Tiered Storage. UpdateStorage allows you to control the Storage Mode for supported storage tiers. (0fd7c71)
• client-neptune: Added a new cluster-level attribute to set the capacity range for Neptune Serverless instances. (5458d9b)
• client-sagemaker: Amazon SageMaker Automatic Model Tuning now supports specifying Grid Search strategy for tuning jobs, which evaluates all hyperparameter combinations exhaustively based on the categorical hyperparameters provided. (a00fdf9)
• clients: update client endpoints as of 2022-10-26 (95631eb)