09-sha256- input- outputEncoding -.md

title	description	excerpt
sha256( input, outputEncoding )	Use SHA-256 to hash input data.	Use SHA-256 to hash input data.

Use sha256 to hash input data.

Parameter	Type	Description
input	string / ArrayBuffer (≥ v0.31.0)	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 / Array	The hash digest as string (for "base64", "base64url", "base64rawurl", "hex" outputEncoding) or raw array of integers (for "binary" outputEncoding).

Example

import crypto from 'k6/crypto';

export default function () {
  let hash = crypto.sha256('hello world!', 'hex');
  console.log(hash);
  const binArray = [104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100, 33];
  hash = crypto.sha256(new Uint8Array(binArray).buffer, 'hex');
  console.log(hash);
}

The above script should result in the following being printed during execution:

INFO[0000] 7509e5bda0c762d2bac7f90d758b5b2263fa01ccbc542ab5e3df163be08e6ca9
INFO[0000] 7509e5bda0c762d2bac7f90d758b5b2263fa01ccbc542ab5e3df163be08e6ca9