Azure SDK for JavaScript (May 2026)
The Azure SDK team is pleased to announce our May 2026 client library releases.
42 packages released this month.
Stable Packages (14)
-
AI Projects
-
Azure AI Search
-
Batch
-
Content Understanding
-
Notification Hubs
-
OpenTelemetry Instrumentation
-
Resource Management - Compute
-
Resource Management - Computelimit
-
Resource Management - Container Service
-
Resource Management - Durable Task
-
Resource Management - IoT Operations
-
Resource Management - Kubernetesconfiguration-Extensions
-
Resource Management - NetApp Files
-
Resource Management - Planetarycomputer
Patch Updates (6)
-
AI Projects
-
Core - Client - AMQP
-
Cosmos DB
-
Event Hubs
-
Key Vault - Secrets
-
Playwright
Beta Packages (22)
-
Content Understanding
-
OpenTelemetry Exporter
-
Resource Management - Alertprocessingrules
-
Resource Management - Alertrulerecommendations
-
Resource Management - Alertsmanagement
-
Resource Management - App Configuration
-
Resource Management - Azure Stack HCI
-
Resource Management - Commerce
-
Resource Management - Communication
-
Resource Management - Cosmos DB
-
Resource Management - Data Factory
-
Resource Management - Fileshares
-
Resource Management - Monitorslis
-
Resource Management - Previewalertrule
-
Resource Management - Prometheusrulegroups
-
Resource Management - Recovery Services Backup
-
Resource Management - Recovery Services Site Recovery
-
Resource Management - Relationships
-
Resource Management - Servicegroups
-
Resource Management - Tenantactivitylogalerts
-
Voice Live
-
unknown
Release highlights
AI Projects 2.1.0 Changelog
Breaking Changes
- Change
container_protocol_versionsproperty from required to optional inHostedAgentDefinitionoutput types. - Change
code_typeproperty from required to optional ingetVersionoutput type. - Rename
idproperty inScheduleinterface toschedule_id
Bugs Fixed
- Remove redundant
foundryFeaturesproperty fromEvaluationRulesCreateOrUpdateOptionalParam
Features Added
- Add
project.beta.agentsroute for accessing beta agent operations such as managed agent identity blueprints, session files, and sessions - Add
project.beta.skillsroute for accessing skills - Add
project.beta.toolboxesroute for accessing toolbox features
AI Projects 2.1.1 Changelog
Bugs Fixed
- Fix agent list operations that only returned the first page of results due to missing cursor-based pagination support
- Fix deserializer incorrectly calling
.map()on the response.
Azure AI Search 13.0.0 Changelog
Features Added
- Added
debugproperty toBaseSearchRequestOptionsto enable debug mode for non-semantic search queries. - Added
oversamplingproperty toBaseVectorQueryfor vector search oversampling configuration. - Added
KnowledgeRetrievalClientfor agentic retrieval operations on knowledge bases. - Added support for knowledge sources with multiple kinds:
searchIndex,azureBlob,indexedOneLake, andweb. - Added
ContentUnderstandingSkillfor enhanced content extraction and understanding in indexer pipelines. - Added
KnowledgeBasemanagement APIs toSearchIndexClientfor creating, updating, and deleting knowledge bases. - Added knowledge source status tracking via
getKnowledgeSourceStatusmethod.
Bugs Fixed
- Fixed
VectorizableImageBinaryQueryto properly mapbinaryImageproperty to the service’sbase64Imagefield.
Breaking Changes
- Upgraded from beta to stable release with API refinements.
- Removed preview-only properties from
KnowledgeBaseinterface:retrievalReasoningEffort,outputMode,retrievalInstructions,answerInstructions.
Batch 13.0.0 Changelog
Breaking Changes
- Renamed
CifsMountConfigurationtoBatchCifsMountConfiguration. ThecifsMountConfigurationproperty inMountConfigurationnow uses the renamed type. - Renamed
BatchSupportedImage.batchSupportEndOfLifetosupportEndDate. - Renamed
BatchNodeDeallocateOptions.nodeDeallocateOptiontonodeDeallocationOption. - Renamed
ExitConditions.defaulttodefaultOptions. - Renamed
VMExtension.typetoextensionType. - Renamed optional parameters across all operation options for consistent casing:
ocpdate→ocpDatetimeOutInSeconds→timeoutInSecondsmaxresults→maxResultsendtime→endTimestarttime→startTime- Removed
AuthenticationTokenSettingsinterface andBatchAccessScopetype. - Removed
authenticationTokenSettingsproperty fromBatchJobManagerTask,BatchTask, andBatchTaskCreateOptions.
Features Added
This stable release includes all features, breaking changes, and bug fixes from the 13.0.0-beta.1 and 13.0.0-beta.2 releases. Refer to the sections below for full details.
For a detailed guide on migrating from v12 to v13, see the Migration Guide.
Content Understanding 1.1.0 Changelog
Features Added
- Billing and token consumption details are now available after analysis operations complete. Access via
poller.operationState?.usage. - The operation ID is now available on the operation state via
poller.operationState?.operationId.
Content Understanding 1.2.0-beta.1 Changelog
Features Added
- Added
toLlmInputhelper that convertsAnalysisResultinto LLM-friendly text with YAML front matter and markdown content. Supports documents, audio/video, and classification hierarchies.
Core - Client - AMQP 4.4.2 Changelog
Bugs Fixed
- Handle
AggregateErrorintranslate()for Node.js 20+ Happy Eyeballs (RFC 8305). When DNS resolution fails over dual-stack connections, Node.js now throws anAggregateErrorbundling IPv4 and IPv6 errors. Thetranslate()function now translates all inner errors and returns a properly annotatedAggregateErrorwith correctretryablesemantics. #38233 - Clamp negative timeout values passed to
setTimeoutto a minimum of 0 when timeout budgets are exceeded in shared request/locking paths, preventingTimeoutNegativeWarningon Node.js v24+ (for example, during CBS authentication). #38166
Cosmos DB 4.9.3 Changelog
Bugs Fixed
- #38124 Fixed incorrect SQL filter generation in ORDER BY queries with continuation tokens. Backslashes and single quotes in
orderByItemvalues are now properly escaped informatValueForSQLbefore being embedded in WHERE clauses.
Event Hubs 6.0.4 Changelog
Bugs Fixed
- Fixed
TimeoutNegativeWarningon Node.js v24+ when timeout budget is exceeded during CBS authentication by clamping remaining-time computations to a minimum of 0. #38166
Key Vault - Secrets 4.11.2 Changelog
Bugs Fixed
- Fixed an issue where
contentTypepassed tosetSecret()andupdateSecretProperties()was not forwarded to the service request body. #38301
Notification Hubs 2.1.0 Changelog
Features Added
- Re-export
RestErrorandisRestErrorfrom@azure/core-rest-pipelinefor convenience.
OpenTelemetry Exporter 1.0.0-beta.40 Changelog
Bugs Fixed
- When multiple
Retry-Afterheaders are received, the exporter now compares absolute deadlines to ensure envelopes are sent at the latest required time.
Features Added
- Persisted telemetry files from previous sessions are now sent immediately on startup instead of waiting for the first successful export plus a 60-second retry interval.
- All persisted files are now processed at startup, not just one file per retry cycle.
- Outdated persisted telemetry is cleaned from disk before sending on startup.
- The exporter now respects the
Retry-Afterheader from the backend when scheduling retries for retriable responses. - Throttled telemetry (429 responses) is now persisted to disk for retry instead of being silently dropped.
- Specific GenAI properties are now truncated to 256KB instead of being exempt from truncation limits.
- The exporter now reads the
MICROSOFT_OPENTELEMETRY_VERSIONenvironment variable and includes it in theai.internal.sdkVersiontag with themotprefix.
Breaking Changes
- The
AZURE_MONITOR_DISABLE_CUSTOM_DIMENSIONS_LIMITenvironment variable is no longer supported. All custom dimension values are truncated to 8KB by default.
OpenTelemetry Instrumentation 1.0.0 Changelog
Features Added
- First stable release of the Azure SDK OpenTelemetry Instrumentation library.
Playwright 1.1.5 Changelog
Bugs Fixed
- Fixed failure during report upload for test runs longer than 5 minutes when using GitHub OIDC authentication.
Resource Management - Alertprocessingrules 1.0.0-beta.1 Changelog
Resource Management - Alertrulerecommendations 1.0.0-beta.1 Changelog
Resource Management - Alertsmanagement 1.0.0-beta.1 Changelog
Resource Management - App Configuration 6.0.0-beta.2 Changelog
Resource Management - Azure Stack HCI 4.1.0-beta.1 Changelog
Resource Management - Commerce 4.0.0-beta.4 Changelog
Resource Management - Communication 5.0.0-beta.1 Changelog
Resource Management - Compute 24.0.0 Changelog
Resource Management - Computelimit 1.0.0 Changelog
Resource Management - Container Service 25.1.0 Changelog
Resource Management - Cosmos DB 17.0.0-beta.3 Changelog
Resource Management - Data Factory 20.0.0-beta.1 Changelog
Resource Management - Durable Task 1.1.0 Changelog
Resource Management - Fileshares 1.0.0-beta.1 Changelog
Resource Management - IoT Operations 2.0.0 Changelog
Resource Management - Kubernetesconfiguration-Extensions 1.0.0 Changelog
Resource Management - Monitorslis 1.0.0-beta.1 Changelog
Resource Management - NetApp Files 24.0.0 Changelog
Resource Management - Planetarycomputer 1.0.0 Changelog
Resource Management - Previewalertrule 1.0.0-beta.1 Changelog
Resource Management - Prometheusrulegroups 1.0.0-beta.1 Changelog
Resource Management - Recovery Services Backup 14.0.0-beta.1 Changelog
Resource Management - Recovery Services Site Recovery 6.0.0-beta.1 Changelog
Resource Management - Relationships 1.0.0-beta.1 Changelog
Resource Management - Servicegroups 1.0.0-beta.1 Changelog
Resource Management - Tenantactivitylogalerts 1.0.0-beta.1 Changelog
Voice Live 1.0.0-beta.4 Changelog
Bugs Fixed
- Fixed
voiceSerializerto properly convert Azure voice properties (e.g.,endpointId,customLexiconUrl) to snake_case wire format (endpoint_id,custom_lexicon_url). Previously, Azure voice objects passed throughrequestSessionSerializerwere sent with camelCase keys, which the service rejected.
Features Added
- Added distributed tracing support via
@azure/core-tracing. Spans are emitted for the session lifecycle (connect,send,recv,close) following GenAI Semantic Conventions. Tracing is no-op by default and activates only when an OpenTelemetry tracer provider is registered — CommonJS apps can use the standard@azure/opentelemetry-instrumentation-azure-sdkbridge, while ESM and browser apps register an Instrumenter directly viauseInstrumenter. See the Telemetry / Distributed Tracing section in the README, plus the newsamples/telemetry/(Node.js ESM, console + Azure Monitor) andsamples/telemetry-browser/(browser, Vite) samples.
unknown 1.0.0-beta.1 Changelog
Features Added
- Added
entraTokenProviderfunction for acquiring Entra ID tokens as PostgreSQL passwords. - Added
configureEntraAuthenticationfunction for automatic Sequelize Entra ID authentication viabeforeConnecthook. - Support for
pg(node-postgres) and Sequelize clients as optional peer dependencies.
Latest Releases
View all the latest versions of JavaScript packages here.
Installation Instructions
To install the packages, copy and paste the below into a terminal.
$> npm install @azure/ai-content-understanding@1.1.0
$> npm install @azure/ai-content-understanding@1.2.0-beta.1
$> npm install @azure/ai-projects@2.1.0
$> npm install @azure/ai-projects@2.1.1
$> npm install @azure/ai-voicelive@1.0.0-beta.4
$> npm install @azure/arm-alertprocessingrules@1.0.0-beta.1
$> npm install @azure/arm-alertrulerecommendations@1.0.0-beta.1
$> npm install @azure/arm-alertsmanagement@1.0.0-beta.1
$> npm install @azure/arm-appconfiguration@6.0.0-beta.2
$> npm install @azure/arm-azurestackhci@4.1.0-beta.1
$> npm install @azure/arm-commerce@4.0.0-beta.4
$> npm install @azure/arm-communication@5.0.0-beta.1
$> npm install @azure/arm-compute@24.0.0
$> npm install @azure/arm-computelimit@1.0.0
$> npm install @azure/arm-containerservice@25.1.0
$> npm install @azure/arm-cosmosdb@17.0.0-beta.3
$> npm install @azure/arm-datafactory@20.0.0-beta.1
$> npm install @azure/arm-durabletask@1.1.0
$> npm install @azure/arm-fileshares@1.0.0-beta.1
$> npm install @azure/arm-iotoperations@2.0.0
$> npm install @azure/arm-kubernetesconfiguration-extensions@1.0.0
$> npm install @azure/arm-monitorslis@1.0.0-beta.1
$> npm install @azure/arm-netapp@24.0.0
$> npm install @azure/arm-planetarycomputer@1.0.0
$> npm install @azure/arm-previewalertrule@1.0.0-beta.1
$> npm install @azure/arm-prometheusrulegroups@1.0.0-beta.1
$> npm install @azure/arm-recoveryservices-siterecovery@6.0.0-beta.1
$> npm install @azure/arm-recoveryservicesbackup@14.0.0-beta.1
$> npm install @azure/arm-relationships@1.0.0-beta.1
$> npm install @azure/arm-servicegroups@1.0.0-beta.1
$> npm install @azure/arm-tenantactivitylogalerts@1.0.0-beta.1
$> npm install @azure/batch@13.0.0
$> npm install @azure/core-amqp@4.4.2
$> npm install @azure/cosmos@4.9.3
$> npm install @azure/event-hubs@6.0.4
$> npm install @azure/keyvault-secrets@4.11.2
$> npm install @azure/monitor-opentelemetry-exporter@1.0.0-beta.40
$> npm install @azure/notification-hubs@2.1.0
$> npm install @azure/opentelemetry-instrumentation-azure-sdk@1.0.0
$> npm install @azure/playwright@1.1.5
$> npm install @azure/postgresql-auth@1.0.0-beta.1
$> npm install @azure/search-documents@13.0.0
Feedback
If you have a bug or feature request for one of the libraries, please post an issue at the azure-sdk-for-js repository