@aws-sdk/util-uri-escape

What is @aws-sdk/util-uri-escape?

The @aws-sdk/util-uri-escape package is part of the AWS SDK for JavaScript and provides utilities for encoding and decoding URI components. It's specifically designed to handle the quirks of URI encoding in a way that's compatible with AWS service expectations. This can be particularly useful when working with AWS services that require specific encoding of URIs for API requests.

What are @aws-sdk/util-uri-escape's main functionalities?

URI encoding

This feature allows you to encode URI components to ensure they are safe to transmit over the network. It is particularly useful for encoding paths and query parameters that may contain characters which have special meanings in URIs.

"import { escapeUri } from '@aws-sdk/util-uri-escape';\nconst encodedUri = escapeUri('/path/to resource?queryParam=value');"

URI decoding

This feature enables the decoding of URI components. It's useful for parsing encoded URIs to retrieve the original data. This can be particularly important when handling encoded URIs received from web requests or other sources.

"import { unescapeUri } from '@aws-sdk/util-uri-escape';\nconst decodedUri = unescapeUri('%2Fpath%2Fto%20resource%3FqueryParam%3Dvalue');"

Other packages similar to @aws-sdk/util-uri-escape

querystring

The querystring package provides utilities for parsing and formatting URL query strings. It's similar to @aws-sdk/util-uri-escape in that it deals with URL encoding and decoding, but it focuses specifically on the query string portion of the URL.

README

@aws-sdk/util-uri-escape

An internal package

Usage

You probably shouldn't, at least directly.

Changelog

3.47.0 (2022-01-15)

Bug Fixes

• codegen: populate dnsSuffix just before consuming hostname (#3170) (0f0e77e)
• codegen: skip variants which only contains tags (#3172) (d72b72a)

Features

• clients: update clients to use default values inferred from defaults mode (#3192) (9152e21)
• Support awsQueryError trait (#3174) (351bd3a)