import type { Faker } from '../..'; /** * The possible definitions related to elements. */ export interface ChemicalElement { /** * The symbol for the element (e.g. `'He'`). */ symbol: string; /** * The name for the element (e.g. `'Cerium'`). */ name: string; /** * The atomic number for the element (e.g. `52`). */ atomicNumber: number; } export interface Unit { /** * The long version of the unit (e.g. `meter`). */ name: string; /** * The short version/abbreviation of the element (e.g. `Pa`). */ symbol: string; } /** * Module to generate science related entries. */ export class Science { constructor(private readonly faker: Faker) { // Bind `this` so namespaced is working correctly for (const name of Object.getOwnPropertyNames(Science.prototype)) { if (name === 'constructor' || typeof this[name] !== 'function') { continue; } this[name] = this[name].bind(this); } } /** * Returns a random periodic table element. * * @example * faker.science.chemicalElement() // { symbol: 'H', name: 'Hydrogen', atomicNumber: 1 } * faker.science.chemicalElement() // { symbol: 'Xe', name: 'Xenon', atomicNumber: 54 } * faker.science.chemicalElement() // { symbol: 'Ce', name: 'Cerium', atomicNumber: 58 } */ chemicalElement(): ChemicalElement { return this.faker.helpers.arrayElement( this.faker.definitions.science.chemicalElement ); } /** * Returns a random scientific unit. * * @example * faker.science.unit() // { name: 'meter', symbol: 'm' } * faker.science.unit() // { name: 'second', symbol: 's' } * faker.science.unit() // { name: 'mole', symbol: 'mol' } */ unit(): Unit { return this.faker.helpers.arrayElement(this.faker.definitions.science.unit); } }