Update k6/crypto to recommend the webcrypto API (#1224)

Co-authored-by: Pepe Cano <[email protected]>

Author: mstoykov

src/components/shared/crypto-blockquote/crypto-blockquote.view.js

@@ -0,0 +1,20 @@
+import Blockquote from 'components/shared/blockquote';
+import React from 'react';
+
+const CryptoBlockquote = () => (
+  <Blockquote mod="info">
+    <h4>A module with a better and standard API exists</h4>
+    <p>
+      The new{' '}
+      <a href="https://k6.io/docs/javascript-api/k6-experimental/webcrypto/">
+        k6/experimental/webcrypto API
+      </a>{' '}
+      partially implements the{' '}
+      <a href="https://www.w3.org/TR/WebCryptoAPI/">WebCryptoAPI</a>, supporting
+      more features than{' '}
+      <a href="https://k6.io/docs/javascript-api/k6-crypto/">k6/crypto</a>.
+    </p>
+  </Blockquote>
+);
+
+export default CryptoBlockquote;

src/components/shared/crypto-blockquote/index.js

@@ -0,0 +1,3 @@
+import CryptoBlockquote from './crypto-blockquote.view';
+
+export default CryptoBlockquote;

src/components/templates/doc-page/doc-page-content/doc-page-content.view.js

@@ -9,6 +9,7 @@ import BrowserDocsWIP from 'components/shared/browser-docs-wip';
 import BrowserWIP from 'components/shared/browser-wip';
 import { Code, CodeInline, CodeGroup } from 'components/shared/code';
 import Collapsible from 'components/shared/collapsible';
+import CryptoBlockquote from 'components/shared/crypto-blockquote';
 import DescriptionList from 'components/shared/description-list';
 import ExperimentalBlockquote from 'components/shared/experimental-blockquote';
 import { HeadingLandmark } from 'components/shared/heading';
@@ -42,6 +43,7 @@ const componentsForNativeReplacement = {
   BrowserWIP,
   ExperimentalBlockquote,
   BlockingAwsBlockquote,
+  CryptoBlockquote,
   WsBlockquote,
   InstallationInstructions,
   Tooltip,

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

@@ -2,7 +2,10 @@
 title: "k6/crypto"
 excerpt: "The k6/crypto module provides common hashing functionality available in the GoLang crypto."
 ---
-The k6/crypto module provides common hashing functionality available in the GoLang [crypto](https://golang.org/pkg/crypto/) package.
+
+<CryptoBlockquote />
+
+The k6/crypto `module` provides common hashing functionality available in the GoLang [crypto](https://golang.org/pkg/crypto/) package.
 
 | Function | Description |
 | -------- | ----------- |

src/data/markdown/docs/02 javascript api/03 k6-crypto/01-createHash- algorithm -.md

@@ -4,6 +4,8 @@ description: 'Create a Hasher object, allowing the user to add data to hash mult
 excerpt: 'Create a Hasher object, allowing the user to add data to hash multiple times, and extract hash digests along the way.'
 ---
 
+<CryptoBlockquote />
+
 Creates a hashing object that can then be fed with data repeatedly, and from which you can extract a hash digest whenever you want.
 
 | Parameter | Type   | Description                                                                                                                                                       |

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

@@ -4,6 +4,8 @@ description: 'Create an HMAC hashing object, allowing the user to add data to ha
 excerpt: 'Create an HMAC hashing object, allowing the user to add data to hash multiple times, and extract hash digests along the way.'
 ---
 
+<CryptoBlockquote />
+
 Creates a HMAC hashing object that can then be fed with data repeatedly, and from which you can extract a signed hash digest whenever you want.
 
 | Parameter |  Type  | Description                                                                                                                         |

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

@@ -4,6 +4,8 @@ description: 'Use HMAC to sign input data.'
 excerpt: 'Use HMAC to sign input data.'
 ---
 
+<CryptoBlockquote />
+
 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                                                                                                                         |

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

@@ -4,6 +4,8 @@ description: 'Use MD4 to hash input data.'
 excerpt: 'Use MD4 to hash input data.'
 ---
 
+<CryptoBlockquote />
+
 Use [md4](https://pkg.go.dev/golang.org/x/crypto/md4) to hash input data.
 
 | Parameter      | Type                 | Description                                       |

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

@@ -4,6 +4,8 @@ description: 'Use MD5 to hash input data.'
 excerpt: 'Use MD5 to hash input data.'
 ---
 
+<CryptoBlockquote />
+
 Use [md5](https://golang.org/pkg/crypto/md5/) to hash input data.
 
 | Parameter      | Type                 | Description                                       |

src/data/markdown/docs/02 javascript api/03 k6-crypto/06-randomBytes- int -.md

@@ -4,6 +4,8 @@ description: 'randomBytes.'
 excerpt: 'randomBytes.'
 ---
 
+<CryptoBlockquote />
+
 Return an ArrayBuffer object with a number of cryptographically random bytes. It will either return exactly the amount of bytes requested or will throw an exception if something went wrong.
 
 | Parameter | Type    | Description                             |