# @google-cloud/datastore > Cloud Datastore Client Library for Node.js Latest version **11.0.1** (published 2026-08-12) · Apache-2.0 license · 0 weekly downloads ## Install ```sh npm install @google-cloud/datastore pnpm add @google-cloud/datastore yarn add @google-cloud/datastore bun add @google-cloud/datastore ``` ## Health **Score 55/100 (C)** — status: active. Positive: has types; no vulnerabilities; recently updated; high maintenance score; high quality score. Warnings: low downloads; no esm support. Negative: declining downloads. ## Facts | | | |---|---| | Version | 11.0.1 | | Published | 2026-08-12 | | First published | 2016-08-11 | | Weekly downloads | 0 | | License | Apache-2.0 | | TypeScript types | bundled | | Module format | CommonJS | | Node | >=22 | | Dependencies | 11 | | Unpacked size | 413.3 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 3196 | | Author | Google LLC. | | Maintainers | google-wombot | | Keywords | google apis client, google api client, google apis, google api, google, google cloud platform, google cloud, cloud, google datastore, datastore | ## Links - npm: https://www.npmjs.com/package/@google-cloud/datastore - Repository: https://github.com/googleapis/google-cloud-node - Homepage: https://github.com/googleapis/google-cloud-node/tree/main/handwritten/datastore - Issues: https://github.com/googleapis/google-cloud-node/issues - npm.io page: https://npm.io/package/@google-cloud/datastore ## Dependencies (11) - [is](https://npm.io/package/is.md) ^3.3.0 - [arrify](https://npm.io/package/arrify.md) ^2.0.0 - [extend](https://npm.io/package/extend.md) ^3.0.2 - [google-gax](https://npm.io/package/google-gax.md) ^6.0.0 - [protobufjs](https://npm.io/package/protobufjs.md) ^7.5.5 - [async-mutex](https://npm.io/package/async-mutex.md) ^0.5.0 - [concat-stream](https://npm.io/package/concat-stream.md) ^2.0.0 - [stream-events](https://npm.io/package/stream-events.md) ^1.0.5 - [split-array-stream](https://npm.io/package/split-array-stream.md) ^2.0.0 - [@google-cloud/promisify](https://npm.io/package/@google-cloud/promisify.md) ^6.0.0 - [@google-cloud/datastore-api](https://npm.io/package/@google-cloud/datastore-api.md) ^0.3.0 ## Alternatives - [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads - [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads - [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads - [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads - [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads ## Recent versions - 11.0.1 (latest) — 2026-08-12 - 10.1.1 (legacy-18) — 2026-06-04 - 9.2.1 (legacy-14) — 2024-11-07 - 6.6.2 (legacy-10) — 2021-11-08 - 5.1.0 (legacy-8) — 2020-03-12 - 11.0.0 — 2026-08-05 - 10.1.0 — 2026-02-09 - 10.0.1 — 2025-05-08 - 9.2.0 — 2024-11-04 - 9.1.0 — 2024-06-26 - 9.0.0 — 2024-05-27 - 8.7.0 — 2024-04-02 - 8.6.0 — 2024-03-25 - 8.5.0 — 2024-02-08 - 8.4.0 — 2024-01-10 - … 94 more at https://npm.io/package/@google-cloud/datastore/versions ## README [//]: # "This README.md file is auto-generated, all changes to this file will be lost." [//]: # "To regenerate it, use `python -m synthtool`." Google Cloud Platform logo # [Google Cloud Datastore: Node.js Client](https://github.com/googleapis/nodejs-datastore) [![release level](https://img.shields.io/badge/release%20level-stable-brightgreen.svg?style=flat)](https://cloud.google.com/terms/launch-stages) [![npm version](https://img.shields.io/npm/v/@google-cloud/datastore.svg)](https://www.npmjs.org/package/@google-cloud/datastore) Cloud Datastore Client Library for Node.js A comprehensive list of changes in each version may be found in [the CHANGELOG](https://github.com/googleapis/nodejs-datastore/blob/main/CHANGELOG.md). * [Google Cloud Datastore Node.js Client API Reference][client-docs] * [Google Cloud Datastore Documentation][product-docs] * [github.com/googleapis/nodejs-datastore](https://github.com/googleapis/nodejs-datastore) Read more about the client libraries for Cloud APIs, including the older Google APIs Client Libraries, in [Client Libraries Explained][explained]. [explained]: https://cloud.google.com/apis/docs/client-libraries-explained **Table of contents:** * [Quickstart](#quickstart) * [Before you begin](#before-you-begin) * [Installing the client library](#installing-the-client-library) * [Using the client library](#using-the-client-library) * [Samples](#samples) * [Versioning](#versioning) * [Contributing](#contributing) * [License](#license) ## Quickstart ### Before you begin 1. [Select or create a Cloud Platform project][projects]. 1. [Enable the Google Cloud Datastore API][enable_api]. 1. [Set up authentication][auth] so you can access the API from your local workstation. ### Installing the client library ```bash npm install @google-cloud/datastore ``` ### Using the client library ```javascript // Imports the Google Cloud client library const {Datastore} = require('@google-cloud/datastore'); // Creates a client const datastore = new Datastore(); async function quickstart() { // The kind for the new entity const kind = 'Task'; // The name/ID for the new entity const name = 'sampletask1'; // The Cloud Datastore key for the new entity const taskKey = datastore.key([kind, name]); // Prepares the new entity const task = { key: taskKey, data: { description: 'Buy milk', }, }; // Saves the entity await datastore.save(task); console.log(`Saved ${task.key.name}: ${task.data.description}`); } quickstart(); ``` ### Troubleshooting #### Emulator returning `DEADLINE_EXCEEDED`, `java.lang.OutOfMemoryError` *Reference Issue: [#95](https://github.com/googleapis/nodejs-datastore/issues/95)* When using the emulator, you may experience errors such as "DEADLINE_EXCEEDED" within your application, corresponding to an error in the emulator: "java.lang.OutOfMemoryError". These errors are unique to the emulator environment and will not persist in production. A workaround is available, provided by [@ohmpatel1997](https://github.com/ohmpatel1997) [here](https://github.com/googleapis/nodejs-datastore/issues/95#issuecomment-554387312). ## Samples Samples are in the [`samples/`](https://github.com/googleapis/nodejs-datastore/tree/main/samples) directory. Each sample's `README.md` has instructions for running its sample. | Sample | Source Code | Try it | | --------------------------- | --------------------------------- | ------ | | Concepts | [source code](https://github.com/googleapis/nodejs-datastore/blob/main/samples/concepts.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/nodejs-datastore&page=editor&open_in_editor=samples/concepts.js,samples/README.md) | | Error | [source code](https://github.com/googleapis/nodejs-datastore/blob/main/samples/error.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/nodejs-datastore&page=editor&open_in_editor=samples/error.js,samples/README.md) | | Export | [source code](https://github.com/googleapis/nodejs-datastore/blob/main/samples/export.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/nodejs-datastore&page=editor&open_in_editor=samples/export.js,samples/README.md) | | Import | [source code](https://github.com/googleapis/nodejs-datastore/blob/main/samples/import.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/nodejs-datastore&page=editor&open_in_editor=samples/import.js,samples/README.md) | | Indexes.get | [source code](https://github.com/googleapis/nodejs-datastore/blob/main/samples/indexes.get.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/nodejs-datastore&page=editor&open_in_editor=samples/indexes.get.js,samples/README.md) | | Indexes.list | [source code](https://github.com/googleapis/nodejs-datastore/blob/main/samples/indexes.list.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/nodejs-datastore&page=editor&open_in_editor=samples/indexes.list.js,samples/README.md) | | Create a union between two filters | [source code](https://github.com/googleapis/nodejs-datastore/blob/main/samples/queryFilterOr.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/nodejs-datastore&page=editor&open_in_editor=samples/queryFilterOr.js,samples/README.md) | | Run query explain (regular query) | [source code](https://github.com/googleapis/nodejs-datastore/blob/main/samples/queryProfileExplain.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/nodejs-datastore&page=editor&open_in_editor=samples/queryProfileExplain.js,samples/README.md) | | Run query explain (aggregate query) | [source code](https://github.com/googleapis/nodejs-datastore/blob/main/samples/queryProfileExplainAggregation.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/nodejs-datastore&page=editor&open_in_editor=samples/queryProfileExplainAggregation.js,samples/README.md) | | Run query explain analyze (regular query) | [source code](https://github.com/googleapis/nodejs-datastore/blob/main/samples/queryProfileExplainAnalyze.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/nodejs-datastore&page=editor&open_in_editor=samples/queryProfileExplainAnalyze.js,samples/README.md) | | Run query explain analyze (aggregate query) | [source code](https://github.com/googleapis/nodejs-datastore/blob/main/samples/queryProfileExplainAnalyzeAggregation.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/nodejs-datastore&page=editor&open_in_editor=samples/queryProfileExplainAnalyzeAggregation.js,samples/README.md) | | Quickstart | [source code](https://github.com/googleapis/nodejs-datastore/blob/main/samples/quickstart.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/nodejs-datastore&page=editor&open_in_editor=samples/quickstart.js,samples/README.md) | | Add Task | [source code](https://github.com/googleapis/nodejs-datastore/blob/main/samples/tasks.add.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/nodejs-datastore&page=editor&open_in_editor=samples/tasks.add.js,samples/README.md) | | Delete Task | [source code](https://github.com/googleapis/nodejs-datastore/blob/main/samples/tasks.delete.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/nodejs-datastore&page=editor&open_in_editor=samples/tasks.delete.js,samples/README.md) | | Legacy Samples | [source code](https://github.com/googleapis/nodejs-datastore/blob/main/samples/tasks.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/nodejs-datastore&page=editor&open_in_editor=samples/tasks.js,samples/README.md) | | List Tasks | [source code](https://github.com/googleapis/nodejs-datastore/blob/main/samples/tasks.list.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/nodejs-datastore&page=editor&open_in_editor=samples/tasks.list.js,samples/README.md) | | Update Task | [source code](https://github.com/googleapis/nodejs-datastore/blob/main/samples/tasks.markdone.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/nodejs-datastore&page=editor&open_in_editor=samples/tasks.markdone.js,samples/README.md) | The [Google Cloud Datastore Node.js Client API Reference][client-docs] documentation also contains samples. ## Supported Node.js Versions Our client libraries follow the [Node.js release schedule](https://github.com/nodejs/release#release-schedule). Libraries are compatible with all current _active_ and _maintenance_ versions of Node.js. If you are using an end-of-life version of Node.js, we recommend that you update as soon as possible to an actively supported LTS version. Google's client libraries support legacy versions of Node.js runtimes on a best-efforts basis with the following warnings: * Legacy versions are not tested in continuous integration. * Some security patches and features cannot be backported. * Dependencies cannot be kept up-to-date. Client libraries targeting some end-of-life versions of Node.js are available, and can be installed through npm [dist-tags](https://docs.npmjs.com/cli/dist-tag). The dist-tags follow the naming convention `legacy-(version)`. For example, `npm install @google-cloud/datastore@legacy-8` installs client libraries for versions compatible with Node.js 8. ## Versioning This library follows [Semantic Versioning](http://semver.org/). This library is considered to be **stable**. The code surface will not change in backwards-incompatible ways unless absolutely necessary (e.g. because of critical security issues) or with an extensive deprecation period. Issues and requests against **stable** libraries are addressed with the highest priority. More Information: [Google Cloud Platform Launch Stages][launch_stages] [launch_stages]: https://cloud.google.com/terms/launch-stages ## Contributing Contributions welcome! See the [Contributing Guide](https://github.com/googleapis/nodejs-datastore/blob/main/CONTRIBUTING.md). Please note that this `README.md`, the `samples/README.md`, and a variety of configuration files in this repository (including `.nycrc` and `tsconfig.json`) are generated from a central template. To edit one of these files, make an edit to its templates in [directory](https://github.com/googleapis/synthtool). ## License Apache Version 2.0 See [LICENSE](https://github.com/googleapis/nodejs-datastore/blob/main/LICENSE) [client-docs]: https://cloud.google.com/nodejs/docs/reference/datastore/latest [product-docs]: https://cloud.google.com/datastore/docs [shell_img]: https://gstatic.com/cloudssh/images/open-btn.png [projects]: https://console.cloud.google.com/project [billing]: https://support.google.com/cloud/answer/6293499#enable-billing [enable_api]: https://console.cloud.google.com/flows/enableapi?apiid=datastore.googleapis.com [auth]: https://cloud.google.com/docs/authentication/external/set-up-adc-local --- _Source: https://npm.io/package/@google-cloud/datastore · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._