Document ArrayBuffer support in k6/crypto module

Part of #233

Author: Ivan Mirić

src/data/markdown/docs/02 javascript api/03 k6-crypto/02-createHMAC- algorithm- secret -.md

@@ -8,7 +8,7 @@ Creates a HMAC hashing object that can then be fed with data repeatedly, and fro
 | Parameter |  Type  | Description                                                                                                                         |
 | --------- | :----: | :---------------------------------------------------------------------------------------------------------------------------------- |
 | algorithm | string | The hashing algorithm to use. One of `md4`, `md5`, `sha1`, `sha256`, `sha384`, `sha512`, `sha512_224`, `sha512_256` or `ripemd160`. |
-| secret    | string | A shared secret used to sign the data.                                                                                              |
+| secret    | string / ArrayBuffer | A shared secret used to sign the data.                                                                                |
 
 ### Returns
 

src/data/markdown/docs/02 javascript api/03 k6-crypto/03-hmac- algorithm- secret- data- outputEncoding -.md

@@ -1,22 +1,23 @@
 ---
 title: 'hmac( algorithm, secret, data, outputEncoding )'
-description: 'Use HMAC to sign an input string.'
+description: 'Use HMAC to sign input data.'
 ---
 
 Use [HMAC](https://en.wikipedia.org/wiki/Hash-based_message_authentication_code) to sign a piece of data using a shared secret.
 
 | Parameter      |  Type  | Description                                                                                                                         |
-| -------------- | :----: | :---------------------------------------------------------------------------------------------------------------------------------- |
+| -------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------- |
 | algorithm      | string | The hashing algorithm to use. One of `md4`, `md5`, `sha1`, `sha256`, `sha384`, `sha512`, `sha512_224`, `sha512_256` or `ripemd160`. |
-| secret         | string | A shared secret used to sign the data.                                                                                              |
-| data           | string | The data to sign.                                                                                                                   |
-| outputEncoding | string | Describes what type of encoding to use for the hash value. Can be "base64" or "hex".                                                |
+| secret         | string / ArrayBuffer | A shared secret used to sign the data.                                                                                              |
+| data           | string / ArrayBuffer | The data to sign.                                                                                                                   |
+| outputEncoding | string | Describes the type of encoding to use for the hash value. Can be "base64", "base64url", "base64rawurl", "hex" or "binary". |
 
 ### Returns
 
-| Type   | Description                    |
-| ------ | ------------------------------ |
-| string | The string-encoded hash digest |
+| Type           | Description                                    |
+| -------------- | ------------------------------                 |
+| string / Array | The hash digest as string (for "base64", "base64url", "base64rawurl", "hex" `outputEncoding`) or raw array of integers (for "binary" `outputEncoding`). |
+
 
 ### Example
 
@@ -28,6 +29,9 @@ import crypto from 'k6/crypto';
 export default function () {
   let hash = crypto.hmac('sha256', 'mysecret', 'hello world!', 'hex');
   console.log(hash);
+  let binArray = [104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100, 33];
+  hash = crypto.hmac('sha256', 'mysecret', new Uint8Array(binArray).buffer, 'hex');
+  console.log(hash);
 }
 ```
 
@@ -39,6 +43,7 @@ The above script should result in the following being printed during execution:
 
 ```bash
 INFO[0000] 893a72d8cab129e5ba85aea4599fd53f59bfe652cff4098a3780313228d8c20f
+INFO[0000] 893a72d8cab129e5ba85aea4599fd53f59bfe652cff4098a3780313228d8c20f
 ```
 
 </CodeGroup>

src/data/markdown/docs/02 javascript api/03 k6-crypto/04-md4- input- outputEncoding -.md

@@ -1,20 +1,20 @@
 ---
 title: 'md4( input, outputEncoding )'
-description: 'Use MD4 to hash an input string.'
+description: 'Use MD4 to hash input data.'
 ---
 
-Use [md4](https://godoc.org/golang.org/x/crypto/md4) to hash an input string.
+Use [md4](https://pkg.go.dev/golang.org/x/crypto/md4) to hash input data.
 
-| Parameter      | Type   | Description                                                                          |
-| -------------- | ------ | ------------------------------------------------------------------------------------ |
-| input          | string | The input string to hash.                                                            |
-| outputEncoding | string | Describes what type of encoding to use for the hash value. Can be "base64" or "hex". |
+| Parameter      | Type                 | Description                                       |
+| -------------- | -------------------- | --------------------------------------------------|
+| input          | string / ArrayBuffer | The input string or `ArrayBuffer` object to hash. |
+| outputEncoding | string               | Describes the type of encoding to use for the hash value. Can be "base64", "base64url", "base64rawurl", "hex" or "binary". |
 
 ### Returns
 
-| Type   | Description                    |
-| ------ | ------------------------------ |
-| string | The string-encoded hash digest |
+| Type           | Description                                    |
+| -------------- | ------------------------------                 |
+| string / Array | The hash digest as string (for "base64", "base64url", "base64rawurl", "hex" `outputEncoding`) or raw array of integers (for "binary" `outputEncoding`). |
 
 ### Example
 
@@ -26,6 +26,9 @@ import crypto from 'k6/crypto';
 export default function () {
   let hash = crypto.md4('hello world!', 'hex');
   console.log(hash);
+  let binArray = [104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100, 33];
+  hash = crypto.md4(new Uint8Array(binArray).buffer, 'hex');
+  console.log(hash);
 }
 ```
 
@@ -35,4 +38,5 @@ The above script should result in the following being printed during execution:
 
 ```bash
 INFO[0000] 3363b72840acd5f49f922fef598ee85d
+INFO[0000] 3363b72840acd5f49f922fef598ee85d
 ```

src/data/markdown/docs/02 javascript api/03 k6-crypto/05-md5- input- outputEncoding -.md

@@ -1,20 +1,20 @@
 ---
 title: 'md5( input, outputEncoding )'
-description: 'Use MD5 to hash an input string.'
+description: 'Use MD5 to hash input data.'
 ---
 
-Use [md5](https://golang.org/pkg/crypto/md5/) to hash an input string.
+Use [md5](https://golang.org/pkg/crypto/md5/) to hash input data.
 
-| Parameter      | Type   | Description                                                                          |
-| -------------- | ------ | ------------------------------------------------------------------------------------ |
-| input          | string | The input string to hash.                                                            |
-| outputEncoding | string | Describes what type of encoding to use for the hash value. Can be "base64" or "hex". |
+| Parameter      | Type                 | Description                                       |
+| -------------- | -------------------- | --------------------------------------------------|
+| input          | string / ArrayBuffer | The input string or `ArrayBuffer` object to hash. |
+| outputEncoding | string               | Describes the type of encoding to use for the hash value. Can be "base64", "base64url", "base64rawurl", "hex" or "binary". |
 
 ### Returns
 
-| Type   | Description                     |
-| ------ | ------------------------------- |
-| string | The string-encoded hash digest. |
+| Type           | Description                                    |
+| -------------- | ------------------------------                 |
+| string / Array | The hash digest as string (for "base64", "base64url", "base64rawurl", "hex" `outputEncoding`) or raw array of integers (for "binary" `outputEncoding`). |
 
 ### Example
 
@@ -26,6 +26,9 @@ import crypto from 'k6/crypto';
 export default function () {
   let hash = crypto.md5('hello world!', 'hex');
   console.log(hash);
+  let binArray = [104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100, 33];
+  hash = crypto.md5(new Uint8Array(binArray).buffer, 'hex');
+  console.log(hash);
 }
 ```
 
@@ -35,4 +38,5 @@ The above script should result in the following being printed during execution:
 
 ```bash
 INFO[0000] fc3ff98e8c6a0d3087d515c0473f8677
+INFO[0000] fc3ff98e8c6a0d3087d515c0473f8677
 ```

src/data/markdown/docs/02 javascript api/03 k6-crypto/07-ripemd160- input- outputEncoding -.md

@@ -1,20 +1,21 @@
 ---
 title: 'ripemd160( input, outputEncoding )'
-description: 'Use RIPEMD-160 to hash an input string.'
+description: 'Use RIPEMD-160 to hash input data.'
 ---
 
-Use [ripemd160](https://godoc.org/golang.org/x/crypto/ripemd160) to hash an input string.
+Use [ripemd160](https://pkg.go.dev/golang.org/x/crypto/ripemd160) to hash input data.
 
-| Parameter      | Type   | Description                                                                          |
-| -------------- | ------ | ------------------------------------------------------------------------------------ |
-| input          | string | The input string to hash.                                                            |
-| outputEncoding | string | Describes what type of encoding to use for the hash value. Can be "base64" or "hex". |
+| Parameter      | Type                 | Description                                       |
+| -------------- | -------------------- | --------------------------------------------------|
+| input          | string / ArrayBuffer | The input string or `ArrayBuffer` object to hash. |
+| outputEncoding | string               | Describes the type of encoding to use for the hash value. Can be "base64", "base64url", "base64rawurl", "hex" or "binary". |
 
 ### Returns
 
-| Type   | Description                     |
-| ------ | ------------------------------- |
-| string | The string-encoded hash digest. |
+| Type           | Description                                    |
+| -------------- | ------------------------------                 |
+| string / Array | The hash digest as string (for "base64", "base64url", "base64rawurl", "hex" `outputEncoding`) or raw array of integers (for "binary" `outputEncoding`). |
+
 
 ### Example
 
@@ -26,6 +27,9 @@ import crypto from 'k6/crypto';
 export default function () {
   let hash = crypto.ripemd160('hello world!', 'hex');
   console.log(hash);
+  let binArray = [104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100, 33];
+  hash = crypto.ripemd160(new Uint8Array(binArray).buffer, 'hex');
+  console.log(hash);
 }
 ```
 
@@ -35,4 +39,5 @@ The above script should result in the following being printed during execution:
 
 ```bash
 INFO[0000] dffd03137b3a333d5754813399a5f437acd694e5
+INFO[0000] dffd03137b3a333d5754813399a5f437acd694e5
 ```

src/data/markdown/docs/02 javascript api/03 k6-crypto/08-sha1- input- outputEncoding -.md

@@ -1,20 +1,21 @@
 ---
 title: 'sha1( input, outputEncoding )'
-description: 'Use SHA-1 to hash an input string.'
+description: 'Use SHA-1 to hash input data.'
 ---
 
-Use [sha1](https://golang.org/pkg/crypto/sha1/) to hash an input string.
+Use [sha1](https://golang.org/pkg/crypto/sha1/) to hash input data.
 
-| Parameter      | Type   | Description                                                                          |
-| -------------- | ------ | ------------------------------------------------------------------------------------ |
-| input          | string | The input string to hash.                                                            |
-| outputEncoding | string | Describes what type of encoding to use for the hash value. Can be "base64" or "hex". |
+| Parameter      | Type                 | Description                                       |
+| -------------- | -------------------- | --------------------------------------------------|
+| input          | string / ArrayBuffer | The input string or `ArrayBuffer` object to hash. |
+| outputEncoding | string               | Describes the type of encoding to use for the hash value. Can be "base64", "base64url", "base64rawurl", "hex" or "binary". |
 
 ### Returns
 
-| Type   | Description                     |
-| ------ | ------------------------------- |
-| string | The string-encoded hash digest. |
+| Type           | Description                                    |
+| -------------- | ------------------------------                 |
+| string / Array | The hash digest as string (for "base64", "base64url", "base64rawurl", "hex" `outputEncoding`) or raw array of integers (for "binary" `outputEncoding`). |
+
 
 ### Example
 
@@ -26,6 +27,9 @@ import crypto from 'k6/crypto';
 export default function () {
   let hash = crypto.sha1('hello world!', 'hex');
   console.log(hash);
+  let binArray = [104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100, 33];
+  hash = crypto.sha1(new Uint8Array(binArray).buffer, 'hex');
+  console.log(hash);
 }
 ```
 
@@ -35,4 +39,5 @@ The above script should result in the following being printed during execution:
 
 ```bash
 INFO[0000] 430ce34d020724ed75a196dfc2ad67c77772d169
+INFO[0000] 430ce34d020724ed75a196dfc2ad67c77772d169
 ```

src/data/markdown/docs/02 javascript api/03 k6-crypto/09-sha256- input- outputEncoding -.md

@@ -1,20 +1,21 @@
 ---
 title: 'sha256( input, outputEncoding )'
-description: 'Use SHA-256 to hash an input string.'
+description: 'Use SHA-256 to hash input data.'
 ---
 
-Use [sha256](https://golang.org/pkg/crypto/sha256/) to hash an input string.
+Use [sha256](https://golang.org/pkg/crypto/sha256/) to hash input data.
 
-| Parameter      | Type   | Description                                                                          |
-| -------------- | ------ | ------------------------------------------------------------------------------------ |
-| input          | string | The input string to hash.                                                            |
-| outputEncoding | string | Describes what type of encoding to use for the hash value. Can be "base64" or "hex". |
+| Parameter      | Type                 | Description                                       |
+| -------------- | -------------------- | --------------------------------------------------|
+| input          | string / ArrayBuffer | The input string or `ArrayBuffer` object to hash. |
+| outputEncoding | string               | Describes the type of encoding to use for the hash value. Can be "base64", "base64url", "base64rawurl", "hex" or "binary". |
 
 ### Returns
 
-| Type   | Description                     |
-| ------ | ------------------------------- |
-| string | The string-encoded hash digest. |
+| Type           | Description                                    |
+| -------------- | ------------------------------                 |
+| string / Array | The hash digest as string (for "base64", "base64url", "base64rawurl", "hex" `outputEncoding`) or raw array of integers (for "binary" `outputEncoding`). |
+
 
 ### Example
 
@@ -26,6 +27,9 @@ import crypto from 'k6/crypto';
 export default function () {
   let hash = crypto.sha256('hello world!', 'hex');
   console.log(hash);
+  let binArray = [104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100, 33];
+  hash = crypto.sha256(new Uint8Array(binArray).buffer, 'hex');
+  console.log(hash);
 }
 ```
 
@@ -35,4 +39,5 @@ The above script should result in the following being printed during execution:
 
 ```bash
 INFO[0000] 7509e5bda0c762d2bac7f90d758b5b2263fa01ccbc542ab5e3df163be08e6ca9
+INFO[0000] 7509e5bda0c762d2bac7f90d758b5b2263fa01ccbc542ab5e3df163be08e6ca9
 ```

src/data/markdown/docs/02 javascript api/03 k6-crypto/10-sha384- input- outputEncoding -.md

@@ -1,20 +1,21 @@
 ---
 title: 'sha384( input, outputEncoding )'
-description: 'Use SHA-384 to hash an input string.'
+description: 'Use SHA-384 to hash input data.'
 ---
 
-Use sha384 to hash an input string.
+Use [sha384](https://golang.org/pkg/crypto/sha512/) to hash input data.
 
-| Parameter      | Type   | Description                                                                          |
-| -------------- | ------ | ------------------------------------------------------------------------------------ |
-| input          | string | The input string to hash.                                                            |
-| outputEncoding | string | Describes what type of encoding to use for the hash value. Can be "base64" or "hex". |
+| Parameter      | Type                 | Description                                       |
+| -------------- | -------------------- | --------------------------------------------------|
+| input          | string / ArrayBuffer | The input string or `ArrayBuffer` object to hash. |
+| outputEncoding | string               | Describes the type of encoding to use for the hash value. Can be "base64", "base64url", "base64rawurl", "hex" or "binary". |
 
 ### Returns
 
-| Type   | Description                     |
-| ------ | ------------------------------- |
-| string | The string-encoded hash digest. |
+| Type           | Description                                    |
+| -------------- | ------------------------------                 |
+| string / Array | The hash digest as string (for "base64", "base64url", "base64rawurl", "hex" `outputEncoding`) or raw array of integers (for "binary" `outputEncoding`). |
+
 
 ### Example
 
@@ -26,6 +27,9 @@ import crypto from 'k6/crypto';
 export default function () {
   let hash = crypto.sha384('hello world!', 'hex');
   console.log(hash);
+  let binArray = [104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100, 33];
+  hash = crypto.sha384(new Uint8Array(binArray).buffer, 'hex');
+  console.log(hash);
 }
 ```
 
@@ -35,4 +39,5 @@ The above script should result in the following being printed during execution:
 
 ```bash
 INFO[0000] d33d40f7010ce34aa86efd353630309ed5c3d7ffac66d988825cf699f4803ccdf3f033230612f0945332fb580d8af805
+INFO[0000] d33d40f7010ce34aa86efd353630309ed5c3d7ffac66d988825cf699f4803ccdf3f033230612f0945332fb580d8af805
 ```

src/data/markdown/docs/02 javascript api/03 k6-crypto/11-sha512- input- outputEncoding -.md

@@ -1,20 +1,21 @@
 ---
 title: 'sha512( input, outputEncoding )'
-description: 'Use SHA-512 to hash an input string.'
+description: 'Use SHA-512 to hash input data.'
 ---
 
-Use [sha512](https://golang.org/pkg/crypto/sha512/) to hash an input string.
+Use [sha512](https://golang.org/pkg/crypto/sha512/) to hash input data.
 
-| Parameter      | Type   | Description                                                                          |
-| -------------- | ------ | ------------------------------------------------------------------------------------ |
-| input          | string | The input string to hash.                                                            |
-| outputEncoding | string | Describes what type of encoding to use for the hash value. Can be "base64" or "hex". |
+| Parameter      | Type                 | Description                                       |
+| -------------- | -------------------- | --------------------------------------------------|
+| input          | string / ArrayBuffer | The input string or `ArrayBuffer` object to hash. |
+| outputEncoding | string               | Describes the type of encoding to use for the hash value. Can be "base64", "base64url", "base64rawurl", "hex" or "binary". |
 
 ### Returns
 
-| Type   | Description                     |
-| ------ | ------------------------------- |
-| string | The string-encoded hash digest. |
+| Type           | Description                                    |
+| -------------- | ------------------------------                 |
+| string / Array | The hash digest as string (for "base64", "base64url", "base64rawurl", "hex" `outputEncoding`) or raw array of integers (for "binary" `outputEncoding`). |
+
 
 ### Example
 
@@ -26,6 +27,9 @@ import crypto from 'k6/crypto';
 export default function () {
   let hash = crypto.sha512('hello world!', 'hex');
   console.log(hash);
+  let binArray = [104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100, 33];
+  hash = crypto.sha512(new Uint8Array(binArray).buffer, 'hex');
+  console.log(hash);
 }
 ```
 
@@ -35,4 +39,5 @@ The above script should result in the following being printed during execution:
 
 ```bash
 INFO[0000] db9b1cd3262dee37756a09b9064973589847caa8e53d31a9d142ea2701b1b28abd97838bb9a27068ba305dc8d04a45a1fcf079de54d607666996b3cc54f6b67c
+INFO[0000] db9b1cd3262dee37756a09b9064973589847caa8e53d31a9d142ea2701b1b28abd97838bb9a27068ba305dc8d04a45a1fcf079de54d607666996b3cc54f6b67c
 ```