Skip to content

System

Generates fake data for many computer systems properties.

commonFileExt

Returns a commonly used file extension.

Available since v3.1.0

Returns: string

ts
function commonFileExt(): string;

Examples

ts
faker.system.commonFileExt() // 'gif'

commonFileName

Returns a random file name with a given extension or a commonly used extension.

Available since v3.1.0

Parameters

NameTypeDefaultDescription
ext?string

Extension. Empty string is considered to be not set.

Returns: string

ts
function commonFileName(ext?: string): string;

Examples

ts
faker.system.commonFileName() // 'dollar.jpg'
faker.system.commonFileName('txt') // 'global_borders_wyoming.txt'

commonFileType

Returns a commonly used file type.

Available since v3.1.0

Returns: string

ts
function commonFileType(): string;

Examples

ts
faker.system.commonFileType() // 'audio'

cron

Returns a random cron expression.

Available since v7.5.0

Parameters

NameTypeDefaultDescription
options{ ... }{}

The optional options to use.

options.includeNonStandard?booleanfalse

Whether to include a @yearly, @monthly, @daily, etc text labels in the generated expression.

options.includeYear?booleanfalse

Whether to include a year in the generated expression.

Returns: string

ts
function cron(
  options: {
    includeYear?: boolean;
    includeNonStandard?: boolean;
  } = {}
): string;

Examples

ts
faker.system.cron() // '45 23 * * 6'
faker.system.cron({ includeYear: true }) // '45 23 * * 6 2067'
faker.system.cron({ includeYear: false }) // '45 23 * * 6'
faker.system.cron({ includeNonStandard: false }) // '45 23 * * 6'
faker.system.cron({ includeNonStandard: true }) // '@yearly'

directoryPath

Returns a directory path.

Available since v3.1.0

Returns: string

ts
function directoryPath(): string;

Examples

ts
faker.system.directoryPath() // '/etc/mail'

fileExt

Returns a file extension.

Available since v3.1.0

Parameters

NameTypeDefaultDescription
mimeType?string

Valid mime-type

Returns: string

ts
function fileExt(mimeType?: string): string;

Examples

ts
faker.system.fileExt() // 'emf'
faker.system.fileExt('application/json') // 'json'

fileName

Returns a random file name with extension.

Available since v3.1.0

Parameters

NameTypeDefaultDescription
options{ ... }{}

An options object.

options.extensionCount?number | { min: number; max: number; }1

Define how many extensions the file name should have.

Returns: string

ts
function fileName(
  options: {
    extensionCount?:
      | number
      | {
          min: number;
          max: number;
        };
  } = {}
): string;

Examples

ts
faker.system.fileName() // 'faithfully_calculating.u8mdn'
faker.system.fileName({ extensionCount: 2 }) // 'times_after.swf.ntf'
faker.system.fileName({ extensionCount: { min: 1, max: 2 } }) // 'jaywalk_like_ill.osfpvg'

filePath

Returns a file path.

Available since v3.1.0

Returns: string

ts
function filePath(): string;

Examples

ts
faker.system.filePath() // '/usr/local/src/money.dotx'

fileType

Returns a file type.

Available since v3.1.0

Returns: string

ts
function fileType(): string;

Examples

ts
faker.system.fileType() // 'message'

mimeType

Returns a mime-type.

Available since v3.1.0

Returns: string

ts
function mimeType(): string;

Examples

ts
faker.system.mimeType() // 'video/vnd.vivo'

networkInterface

Returns a random network interface.

Available since v7.4.0

Parameters

NameTypeDefaultDescription
options{ ... }{}

The options to use.

options.interfaceSchema?'index' | 'slot' | 'mac' | 'pci'faker.helpers.objectKey(['index' | 'slot' | 'mac' | 'pci'])

The interface schema. Can be one of index, slot, mac, pci.

options.interfaceType?'en' | 'wl' | 'ww'faker.helpers.arrayElement(['en', 'wl', 'ww'])

The interface type. Can be one of en, wl, ww.

Returns: string

ts
function networkInterface(
  options: {
    interfaceType?: (typeof commonInterfaceTypes)[number];
    interfaceSchema?: keyof typeof commonInterfaceSchemas;
  } = {}
): string;

Examples

ts
faker.system.networkInterface() // 'enp0s3'
faker.system.networkInterface({ interfaceType: 'wl' }) // 'wlo1'
faker.system.networkInterface({ interfaceSchema: 'mac' }) // 'enx000c29c00000'
faker.system.networkInterface({ interfaceType: 'en', interfaceSchema: 'pci' }) // 'enp5s0f1d0'

semver

Returns a semantic version.

Available since v3.1.0

Returns: string

ts
function semver(): string;

Examples

ts
faker.system.semver() // '1.1.2'

Released under the MIT License.