Method numeric

src/modules/string/index.ts:568–647

* Generates a given length string of digits. * * @param options Either the length of the string to generate or the optional options object. * @param options.length The length of the string to generate either as a fixed length or as a length range. Defaults to `1`. * @param options.allowL

(
    options:
      | number
      | {
          /**
           * The length of the string to generate either as a fixed length or as a length range.
           *
           * @default 1
           */
          length?:
            | number
            | {
                /**
                 * The minimum length of the string to generate.
                 */
                min: number;
                /**
                 * The maximum length of the string to generate.
                 */
                max: number;
              };
          /**
           * Whether leading zeros are allowed or not.
           *
           * @default true
           */
          allowLeadingZeros?: boolean;
          /**
           * An array of digits which should be excluded in the generated string.
           *
           * @default []
           */
          exclude?: ReadonlyArray<LiteralUnion<NumericChar>> | string;
        } = {}
  )

   * @since 8.0.0
   */
  numeric(
    options:
      | number
      | {
          /**
           * The length of the string to generate either as a fixed length or as a length range.
           *
           * @default 1
           */
          length?:
            | number
            | {
                /**
                 * The minimum length of the string to generate.
                 */
                min: number;
                /**
                 * The maximum length of the string to generate.
                 */
                max: number;
              };
          /**
           * Whether leading zeros are allowed or not.
           *
           * @default true
           */
          allowLeadingZeros?: boolean;
          /**
           * An array of digits which should be excluded in the generated string.
           *
           * @default []
           */
          exclude?: ReadonlyArray<LiteralUnion<NumericChar>> | string;
        } = {}
  ): string {
    if (typeof options === 'number') {
      options = {
        length: options,
      };
    }

    const length = this.faker.helpers.rangeToNumber(options.length ?? 1);
    if (length <= 0) {
      return '';
    }

    const { allowLeadingZeros = true } = options;
    let { exclude = [] } = options;

    if (typeof exclude === 'string') {
      exclude = [...exclude];
    }

    const allowedDigits = DIGIT_CHARS.filter(
      (digit) => !exclude.includes(digit)
    );

    if (