Skip to content

Commerce

Module to generate commerce and product related entries.

Overview

For a long product name like 'Incredible Soft Gloves', use productName(). The product names are generated from a list of adjectives, materials, and products, which can each be accessed separately using productAdjective(), productMaterial(), and product(). You can also create a description using productDescription().

For a department in a shop or product category, use department().

You can also create a price using price().

department

Returns a department inside a shop.

Available since v3.0.0

Returns: string

ts
function department(): string;
faker.commerce.department() // 'Garden'

isbn

Returns a random ISBN identifier.

Available since v8.1.0

Parameters

NameTypeDefaultDescription
options10 | 13 | { ... }{}

The variant to return or an options object.

options.separator?string'-'

The separator to use in the format.

options.variant?10 | 1313

The variant of the identifier to return. Can be either 10 (10-digit format) or 13 (13-digit format).

Returns: string

ts
function isbn(
    options:
      | 10
      | 13
      | {
          variant?: 10 | 13;
          separator?: string;
        } = {}
  ): string;
faker.commerce.isbn() // '978-0-692-82459-7'
faker.commerce.isbn(10) // '1-155-36404-X'
faker.commerce.isbn(13) // '978-1-60808-867-6'
faker.commerce.isbn({ separator: ' ' }) // '978 0 452 81498 1'
faker.commerce.isbn({ variant: 10, separator: ' ' }) // '0 940319 49 7'
faker.commerce.isbn({ variant: 13, separator: ' ' }) // '978 1 6618 9122 0'

price

Generates a price between min and max (inclusive).

To better represent real-world prices, when options.dec is greater than 0, the final decimal digit in the returned string will be generated as follows:

  • 50% of the time: 9
  • 30% of the time: 5
  • 10% of the time: 0
  • 10% of the time: a random digit from 0 to 9

Available since v3.0.0

Parameters

NameTypeDefaultDescription
options{ ... }{}

An options object.

options.dec?number2

The number of decimal places.

options.max?number1000

The maximum price.

options.min?number1

The minimum price.

options.symbol?string''

The currency value to use.

Returns: string

ts
function price(
    options: {
      min?: number;
      max?: number;
      dec?: number;
      symbol?: string;
    } = {}
  ): string;
faker.commerce.price() // 828.07
faker.commerce.price({ min: 100 }) // 904.19
faker.commerce.price({ min: 100, max: 200 }) // 154.55
faker.commerce.price({ min: 100, max: 200, dec: 0 }) // 133
faker.commerce.price({ min: 100, max: 200, dec: 0, symbol: '$' }) // $114

product

Returns a short product name.

Available since v3.0.0

Returns: string

ts
function product(): string;
faker.commerce.product() // 'Computer'

productAdjective

Returns an adjective describing a product.

Available since v3.0.0

Returns: string

ts
function productAdjective(): string;
faker.commerce.productAdjective() // 'Handcrafted'

productDescription

Returns a product description.

Available since v5.0.0

Returns: string

ts
function productDescription(): string;
faker.commerce.productDescription() // 'Andy shoes are designed to keeping...'

productMaterial

Returns a material of a product.

Available since v3.0.0

Returns: string

ts
function productMaterial(): string;
faker.commerce.productMaterial() // 'Rubber'

productName

Generates a random descriptive product name.

Available since v3.0.0

Returns: string

ts
function productName(): string;
faker.commerce.productName() // 'Incredible Soft Gloves'

Released under the MIT License.