Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current 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';

let file;
(async function () {
  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);
}