# Supported JavaScript runtimes

This SDK is intended to be used in JavaScript runtimes that support ECMAScript 2020 or newer. The SDK uses the following features:

* [Web Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API)
* [Web Streams API](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API) and in particular `ReadableStream`
* [Async iterables](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#the_async_iterator_and_async_iterable_protocols) using `Symbol.asyncIterator`

Runtime environments that are explicitly supported are:

* Evergreen browsers which include: Chrome, Safari, Edge, Firefox
* Node.js active and maintenance LTS releases
  * Currently, this is v18 and v20
* Bun v1 and above
* Deno v1.39
  * Note that Deno does not currently have native support for streaming file uploads backed by the filesystem ([issue link](https://github.com/denoland/deno/issues/11018))

## Recommended TypeScript compiler options

The following `tsconfig.json` options are recommended for projects using this SDK in order to get static type support for features like async iterables, streams and `fetch`-related APIs ([`for await...of`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/for-await...of), [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal), [`Request`](https://developer.mozilla.org/en-US/docs/Web/API/Request), [`Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response) and so on):

```jsonc
{
  "compilerOptions": {
    "target": "es2020", // or higher
    "lib": ["es2020", "dom", "dom.iterable"]
  }
}
```

While `target` can be set to older ECMAScript versions, it may result in extra, unnecessary compatibility code being generated if you are not targeting old runtimes.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.incidents.cloud.solarwinds.com/typescript/runtimes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.