---
hide_title: false
hide_table_of_contents: false
pagination_next: null
pagination_prev: null
---
# TextDecoder.decode()

The **`TextDecoder.decode()`** method returns a string containing text decoded from the buffer passed as a parameter.

The decoding method is defined in the current `TextDecoder` object.
This includes the expected encoding of the data, and how decoding errors are handled.

## Syntax

```js
decode()
decode(buffer)
decode(buffer, options)
```

### Parameters

- `buffer` _**optional**_
  - : Is an `ArrayBuffer`, a `TypedArray` or a `DataView` object containing the encoded text to decode.
- `options` _**optional**_

  - : An object with the property:

    - `stream`
      - : A boolean flag indicating that additional data will follow in subsequent calls to `decode()`.
        Set to `true` if processing the data in chunks, and `false` for the final chunk or if the data is not chunked.
        It defaults to `false`.

### Exceptions

- `TypeError`
  - : Thrown if there is a decoding error when the property `TextDecoder.fatal` is `true`.

### Return value

A string.
