This is documentation for the next version of K6. For the latest stable release, go to the latest version.

Documentation Grafana k6 JavaScript API k6/experimental fs File seek

seek

The seek method sets the file position indicator for the file to the passed offset bytes, under the mode given by whence. The call resolves to the new position within the resource (bytes from the start).

Based on the SeekMode passed, the offset is interpreted as follows:

• when using SeekMode.Start, the offset must be greater than or equal to zero.
• when using SeekMode.Current, the offset can be positive or negative.
• when using SeekMode.End, the offset must be less than or equal to zero.

Parameters

Returns

A Promise resolving to the new offset within the file.

Example

JavaScript

Copy

JavaScript Copy

import { open, SeekMode } from 'k6/experimental/fs';

const file = await open('bonjour.txt');

export default async function () {
  // Seek 6 bytes from the start of the file
  await file.seek(6, SeekMode.Start);

  // Seek 2 more bytes from the current position
  await file.seek(2, SeekMode.Current);

  // Seek backwards 2 bytes from the end of the file
  await file.seek(-2, SeekMode.End);
}