ssn-validation
TypeScript icon, indicating that this package has built-in type declarations

3.0.0 • Public • Published

ssn-validation

Validate and mask a U.S. Social Security Number (SSN). Validate and mask Canadian SIN's too.

Installation

Install the package via npm:

npm install ssn-validation --save

Usage

isValid(value)

This method validates if the given value is a valid Social Security Number.

Arguments

  1. value (*): The value to validate.

Returns

(boolean): Returns whether the input value is a valid SSN or not.

Example

isValid({});
// => false

isValid('0-1-1234567');
// => false

isValid('011-23-4567');
// => true

isValid('011234567');
// => true

mask(value)

This method will help you protect this sensitive piece of information by obfuscating some digits.

Arguments

  1. value (*): The value to mask.

Returns

(string): Returns the masked value by replacing value certain digits by 'X'.

Example

mask({});
// Throws an Error.

mask('0-1-1234567');
// Throws an Error.

mask('011-23-4567');
// => XXX-XX-4567

mask('011234567');
// => XXXXX4567

Tests

To test using a local installation of node.js:

npm test

License

MIT

Dependencies (0)

    Dev Dependencies (9)

    Package Sidebar

    Install

    npm i ssn-validation

    Weekly Downloads

    12

    Version

    3.0.0

    License

    MIT

    Unpacked Size

    21.1 kB

    Total Files

    17

    Last publish

    Collaborators

    • ronpenton