Update article.md

Author: Vladimir Troyanenko

4-binary/02-text-decoder/article.md

@@ -1,30 +1,30 @@
-# TextDecoder and TextEncoder
+# TextDecoder и TextEncoder
 
-What if the binary data is actually a string? For instance, we received a file with textual data.
+Что если бинарные данные фактически являются строкой? Например, мы получили файл с текстовыми данными.
 
-The build-in [TextDecoder](https://encoding.spec.whatwg.org/#interface-textdecoder) object allows to read the value into an an actual Javascript string, given the buffer and the encoding.
+Встроенный [TextDecoder](https://encoding.spec.whatwg.org/#interface-textdecoder) объект позволяет декодировать данные из бинарного буфера в обычную строку.
 
-We first need to create it:
+Для этого прежде всего нам нужно создать сам декодер:
 ```js
 let decoder = new TextDecoder([label], [options]);
 ```
 
-- **`label`** -- the encoding, `utf-8` by default, but `big5`, `windows-1251` and many other are also supported.
-- **`options`** -- optional object:
-  - **`fatal`** -- boolean, if `true` then throw an exception for invalid (non-decodable) characters, otherwise (default) replace them with character `\uFFFD`.
-  - **`ignoreBOM`** -- boolean, if `true` then ignore BOM (an optional byte-order unicode mark), rarely needed.
+- **`label`** -- тип кодировки, `utf-8`используется по умолчанию, но также поддерживаются `big5`, `windows-1251` и многие другие.
+- **`options`** -- объект с дополнительными настройками:
+  - **`fatal`** -- boolean, если `true` тогда генерируется ошибка для не валидных (не декодируемых) символов, в ином случае (по умолчанию) они заменяются символом `\uFFFD`.
+  - **`ignoreBOM`** -- boolean, если `true` тогда игнорируется BOM (дополнительный признак определяющий порядок следования байтов), что необходимо крайне редко.
 
-...And then decode:
+...и после использовать его метод decode:
 
 ```js
 let str = decoder.decode([input], [options]);
 ```
 
-- **`input`** -- `BufferSource` to decode.
-- **`options`** -- optional object:
-  - **`stream`** -- true for decoding streams, when `decoder` is called repeatedly with incoming chunks of data. In that case a multi-byte character may occasionally split between chunks. This options tells `TextDecoder` to memorize "unfinished" characters and decode them when the next chunk comes.
+- **`input`** -- `BufferSource` бинарный буфер.
+- **`options`** -- объект с дополнительными настройками:
+  - **`stream`** -- true для декодирования потока данных, при этом `decoder` вызывается вновь и вновь для каждого следующего фрагмента данных. В этом случае многобайтовой символ может иногда быть разделен и попасть до разных фрагментов данных. Это опция заставляет `TextDecoder` запомнить "разбитый" символ и декодировать его только после того как придет его недостающая часть.
 
-For instance:
+Например:
 
 ```js run
 let uint8Array = new Uint8Array([72, 101, 108, 108, 111]);
@@ -39,38 +39,38 @@ let uint8Array = new Uint8Array([228, 189, 160, 229, 165, 189]);
 alert( new TextDecoder().decode(uint8Array) ); // 你好
 ```
 
-We can decode a part of the buffer by creating a subarray view for it:
+Мы так же может декодировать часть бинарного массива вычленив подмассив :
 
 
 ```js run
 let uint8Array = new Uint8Array([0, 72, 101, 108, 108, 111, 0]);
 
-// the string is in the middle
-// create a new view over it, without copying anything
+// возьмем строку из середины массива
 let binaryString = uint8Array.subarray(1, -1);
 
 alert( new TextDecoder().decode(binaryString) ); // Hello
 ```
 
 ## TextEncoder
 
-[TextEncoder](https://encoding.spec.whatwg.org/#interface-textencoder) does the reverse thing -- converts a string into bytes.
+[TextEncoder](https://encoding.spec.whatwg.org/#interface-textencoder) поступает наоборот – кодирует строку в бинарный массив.
 
-The syntax is:
+Имеет следующий синтаксис:
 
 ```js run
 let encoder = new TextEncoder();
 ```
 
-The only encoding it supports is "utf-8".
+Поддерживается только "utf-8" кодировка.
 
-It has two methods:
-- **`encode(str)`** -- returns `Uint8Array` from a string.
-- **`encodeInto(str, destination)`** -- encodes `str` into `destination` that must be `Uint8Array`.
+Кодировщик имеет следующие два метода:
+- **`encode(str)`** -- возвращает строку  закодированную в `Uint8Array` бинарный массив.
+- **`encodeInto(str, destination)`** -- кодирует `str` (строку) в `destination` (адресат) который должен быть бинарным массивом  `Uint8Array`.
 
 ```js run
 let encoder = new TextEncoder();
 
 let uint8Array = encoder.encode("Hello");
 alert(uint8Array); // 72,101,108,108,111
 ```
+