Usage

toInt("1.23"); // => 1
toInt("foo"); // => 0
toInt("1.23px", 1); // => 1
toInt("foo", -1); // => -1

Installation

CLI

npx atmx add helper toInt

Manually

Copy and paste the following method into @/utils/helpers/undefined.ts:

import { isSymbol } from "@/helpers/is-symbol.ts";

/**
* Combines `Number.parseInt` with NaN handling. By default, a zero
* (0) is returned in place of NaN.
*
* @example
* toInt("1.23") // => 1
* toInt("foo") // => 0
* toInt("1.23px", 1) // => 1
* toInt("foo", -1) // => -1
*/
export function toInt(value: unknown): number;

export function toInt<T>(
value: unknown,
defaultValue: T | undefined,
): number | T;

export function toInt<T>(
value: any,
defaultValue?: T,
): number | Exclude<T, undefined> {
// Symbols throw on string coercion, which parseInt does.
const parsedValue = isSymbol(value) ? Number.NaN : Number.parseInt(value);
return Number.isNaN(parsedValue)
? defaultValue !== undefined
  ? (defaultValue as Exclude<T, undefined>)
  : 0
: parsedValue;
}