Version 4 of the SDK is open source, built entirely in TypeScript, and designed for modern JavaScript development. It offers full support for Promises and the async\/await pattern, enabling clean and efficient coding. The SDK also follows official JavaScript SDK design guidelines to ensure consistency and reliability.<\/p>\n For a complete overview of features, documentation, and code samples, visit the JavaScript SDK Change Log<\/a>. Whether upgrading from an earlier version or starting from scratch, it\u2019s the go-to resource for getting up to speed.<\/p>\n This blog highlights some of the most impactful updates in the release\u2014and how they can help accelerate application development with Azure Cosmos DB.<\/p>\n Improved Query Control in Azure Cosmos DB JavaScript SDK<\/strong><\/p>\n The Azure Cosmos DB JavaScript SDK introduces a new query pipeline to give developers finer control over query execution and improve transparency.<\/p>\n What\u2019s Changed?<\/strong><\/p>\n Previously, each fetchNext call aimed to return up to maxItemCount results, often triggering multiple partition queries behind the scenes. This caused:<\/p>\n \ud83c\udd95Benefits of the New Query Pipeline<\/strong><\/p>\n \u2699\ufe0f How to Enable It<\/strong><\/p>\n Use the enableQueryControl flag in FeedOptions:<\/p>\n \ud83d\udd0d How It Works<\/strong><\/p>\n When enableQueryControl is true, each fetchNext:<\/p>\n Queries a limited number of partitions (up to maxDegreeOfParallelism).<\/p>\n \ud83d\udd04 Backward Compatibility<\/strong><\/p>\n The flag is disabled by default<\/strong> (enableQueryControl: false), ensuring existing behavior is preserved.<\/p>\n \ud83d\udced Handling Empty Pages<\/strong><\/p>\n The new executeBulkOperations API in the Azure Cosmos DB JavaScript SDK introduces major improvements for handling bulk workloads. This release addresses previous limitations and delivers powerful enhancements that streamline performance and efficiency at scale. Here\u2019s what\u2019s new:<\/p>\n These enhancements make the JavaScript SDK’s bulk support more scalable, fault-tolerant, and adaptive, perfect for high-volume workloads in modern cloud applications.<\/p>\n Follow the sample here<\/a> for more details.<\/p>\n Azure Cosmos DB now supports Always Encrypted<\/strong> for Node.js applications, enabling client-side encryption to protect sensitive data before it ever leaves the application. With the Cosmos DB JavaScript SDK, developers can easily encrypt and decrypt specific properties within documents\u2014while keeping encryption keys entirely under their control.<\/p>\n The integration is simple: define a protected data encryption key and apply encryption policies directly in container operations. Here\u2019s a quick \u00a0example<\/a>!<\/p>\n This feature empowers developers to meet stricter compliance and security requirements, all while maintaining a familiar development experience in Node.js.<\/p>\n The Azure Cosmos DB JavaScript SDK now includes powerful AI-driven features. With built-in support for Vector Search, Full-Text Search for advanced text indexing and querying, and Hybrid Search that combines keyword and vector semantics, developers can seamlessly build intelligent, search-enhanced applications. Learn more about Full-Text Search<\/a> and Hybrid Search<\/a>.<\/p>\n This release introduces key stable enhancements including Partition Merge support, partial hierarchical partition key handling in Change Feed, index metrics, client-side request diagnostics, and additional features to optimize JavaScript applications with Azure Cosmos DB.<\/p>\n Thinking of upgrading to JavaScript SDK v4? Here\u2019s a quick summary of the versions we\u2019ve released so far and the relevant Change Log.<\/p>\n![\"V4BLOG](\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2025\/05\/V4BLOG.png\")
<\/a><\/p>\nLatest Enhancements in the JavaScript SDK<\/strong><\/h2>\n
\n
\n
const<\/span> queryOptions<\/span>: FeedOptions<\/span> = { \r\n maxDegreeOfParallelism<\/span>: 3<\/span>, \r\n maxItemCount<\/span>: 10<\/span>, \r\n enableQueryControl<\/span>: true<\/span> \/\/ Enables the new query pipeline. Default value is false<\/span>\r\n}); <\/code><\/pre>\n\n
\n
\n
Unlocking Efficient Bulk Workloads with the New executeBulkOperations API in the JavaScript SDK<\/strong><\/h3>\n
\n
Client-side encryption support<\/strong>\u200b<\/strong><\/h3>\n
New AI Search Capabilities <\/strong><\/h3>\n
And Much more! <\/strong><\/h3>\n
Upgrade to JavaScript SDK v4<\/strong><\/h3>\n