totp on Grafana Labs

TOTP(secret, [digits])

Mon, 21 Sep 2026 15:16:28 +0000

TOTP(secret, [digits])

Creates a new TOTP (Time-based One-Time Password) instance with the given secret.

Parameter	Type	Description
secret	string	Base32 encoded secret key
digits (optional)	number	Number of digits in the generated code (default: 6)

Returns

Type	Description
TOTP	A new TOTP object

Example

import { TOTP } from 'https://jslib.k6.io/totp/1.0.0/index.js';

export default async function () {
  // Create a TOTP instance with 6 digits (default)
  const totp6 = new TOTP('GEZDGNBVGY3TQOJQGEZDGNBVGY3TQOJQ');

  // Create a TOTP instance with 8 digits
  const totp8 = new TOTP('GEZDGNBVGY3TQOJQGEZDGNBVGY3TQOJQ', 8);

  const code = await totp6.gen();
  console.log(`6-digit TOTP: ${code}`);
}

TOTP.gen([timeStep], [bias])

Mon, 21 Sep 2026 15:16:28 +0000

TOTP.gen([timeStep], [bias])

Generates a TOTP code for the current time.

Parameter	Type	Description
timeStep (optional)	number	Time step in seconds (default: 30)
bias (optional)	number	Time bias in seconds to offset the current time (default: 0)

Returns

Type	Description
Promise	The generated TOTP code

Example

import { TOTP } from 'https://jslib.k6.io/totp/1.0.0/index.js';

export default async function () {
  const totp = new TOTP('GEZDGNBVGY3TQOJQGEZDGNBVGY3TQOJQ', 6);

  // Generate code with default 30-second time step
  const code = await totp.gen();
  console.log(`TOTP code: ${code}`);

  // Generate code with 60-second time step
  const code60 = await totp.gen(60);
  console.log(`TOTP code (60s step): ${code60}`);
}

TOTP.verify(code, [timeStep])

Mon, 21 Sep 2026 15:16:28 +0000

TOTP.verify(code, [timeStep])

Verifies a TOTP code against the current time.

Parameter	Type	Description
code	string	The TOTP code to verify
timeStep (optional)	number	Time step in seconds (default: 30)

Returns

Type	Description
Promise	`true` if the code is valid, `false` otherwise

Example

import { TOTP } from 'https://jslib.k6.io/totp/1.0.0/index.js';

export default async function () {
  const totp = new TOTP('GEZDGNBVGY3TQOJQGEZDGNBVGY3TQOJQ', 6);

  // Generate and verify a code
  const code = await totp.gen();
  const isValid = await totp.verify(code);

  if (isValid) {
    console.log('Code is valid!');
  } else {
    console.log('Code is invalid!');
  }
}