@aws-sdk/util-body-length-node

What is @aws-sdk/util-body-length-node?

The @aws-sdk/util-body-length-node package is a utility module from the AWS SDK for JavaScript (v3). It is designed to calculate the body length of HTTP requests in Node.js environments. This is particularly useful when working with AWS services that require content-length headers for request validation. The package provides a straightforward API to accurately determine the length of various types of request bodies, including Buffer, Blob, and string objects.

What are @aws-sdk/util-body-length-node's main functionalities?

Calculate Buffer Body Length

This feature allows you to calculate the length of a Buffer object. It is useful when you need to determine the size of a binary file or data stream before sending it in an HTTP request.

const { calculateBodyLength } = require('@aws-sdk/util-body-length-node');
const buffer = Buffer.from('Hello World');
const length = calculateBodyLength(buffer);
console.log(length); // Outputs: 11

Calculate String Body Length

This feature enables the calculation of the length of a string. It's beneficial when dealing with textual data, ensuring you can set the correct content-length header for HTTP requests.

const { calculateBodyLength } = require('@aws-sdk/util-body-length-node');
const stringBody = 'Hello World';
const length = calculateBodyLength(stringBody);
console.log(length); // Outputs: 11

Other packages similar to @aws-sdk/util-body-length-node

content-length

The 'content-length' package offers functionality to calculate the content length of given data. It supports strings, buffers, and streams. Compared to @aws-sdk/util-body-length-node, it provides broader support for different types of data, including streams, but it is not specifically optimized for or tied to AWS SDK usage.

byte-length

The 'byte-length' package is another utility for calculating the byte length of strings in various encodings. While it focuses on string data and supports multiple encodings, @aws-sdk/util-body-length-node is more focused on AWS SDK integration and supports both Buffer and string types directly.

README

@aws-sdk/util-body-length-node

Determines the length of a request body in node.js

An internal package

Usage

You probably shouldn't, at least directly.

Changelog

3.208.0 (2022-11-10)

Bug Fixes

• aws-client-api-test: rename package (#4165) (2e13b67)
• types: add client config interface test with s3 example (#4156) (7811cd9)

Features

• client-ec2: This release adds a new price capacity optimized allocation strategy for Spot Instances to help customers optimize provisioning of Spot Instances via EC2 Auto Scaling, EC2 Fleet, and Spot Fleet. It allocates Spot Instances based on both spare capacity availability and Spot Instance price. (6f4d604)
• client-ecs: This release adds support for task scale-in protection with updateTaskProtection and getTaskProtection APIs. UpdateTaskProtection API can be used to protect a service managed task from being terminated by scale-in events and getTaskProtection API to get the scale-in protection status of a task. (a5eede0)
• client-elasticsearch-service: Amazon OpenSearch Service now offers managed VPC endpoints to connect to your Amazon OpenSearch Service VPC-enabled domain in a Virtual Private Cloud (VPC). This feature allows you to privately access OpenSearch Service domain without using public IPs or requiring traffic to traverse the Internet. (f36b021)
• client-scheduler: AWS introduces the new Amazon EventBridge Scheduler. EventBridge Scheduler is a serverless scheduler that allows you to create, run, and manage tasks from one central, managed service. (8829f71)
• clients: update client endpoints as of 2022-11-10 (c01499d)
• private: add server artifacts (#4159) (e70f472)