is-string

What is is-string?

The is-string npm package is designed to provide a simple and straightforward way to check if a given value is a string. It is useful in various programming scenarios where type validation is required, especially in dynamically typed languages like JavaScript where the type of a variable can change at runtime.

What are is-string's main functionalities?

String Type Checking

This feature allows you to check if a given value is a string. It returns true for string literals, string objects created with the new keyword, and false for non-string values.

"use strict";\nconst isString = require('is-string');\n\nconsole.log(isString('hello')); // true\nconsole.log(isString(123)); // false\nconsole.log(isString(new String('hello'))); // true

Other packages similar to is-string

lodash.isstring

Similar to is-string, lodash.isstring is a method offered by lodash, a popular utility library. It provides a more comprehensive suite of utilities for various types, but for string checking, it offers similar functionality. Compared to is-string, lodash.isstring comes as part of a larger library, which might not be ideal for projects looking to minimize dependencies.

validator

Validator is a library for string validation and sanitization. While it includes functions to check if a value is a string, its primary focus is on validating and sanitizing strings to ensure they meet certain conditions (e.g., email format, length). It's more feature-rich compared to is-string but also more complex if you only need type checking.

README

is-string

Is this value a JS String object or primitive? This module works cross-realm/iframe, and despite ES6 @@toStringTag.

Example

var isString = require('is-string');
var assert = require('assert');

assert.notOk(isString(undefined));
assert.notOk(isString(null));
assert.notOk(isString(false));
assert.notOk(isString(true));
assert.notOk(isString(function () {}));
assert.notOk(isString([]));
assert.notOk(isString({}));
assert.notOk(isString(/a/g));
assert.notOk(isString(new RegExp('a', 'g')));
assert.notOk(isString(new Date()));
assert.notOk(isString(42));
assert.notOk(isString(NaN));
assert.notOk(isString(Infinity));
assert.notOk(isString(new Number(42)));

assert.ok(isString('foo'));
assert.ok(isString(Object('foo')));

Tests

Simply clone the repo, npm install, and run npm test

Changelog

v1.1.1 - 2024-12-15

Commits

• [Dev Deps] update @arethetypeswrong/cli, @ljharb/tsconfig, @types/tape c1f7ef7
• [Refactor] use call-bound directly ba8a78f
• [Deps] update call-bind 93c352f