Validatem validator for ensuring that a value is a string
npm install @validatem/is-stringThis validator is designed to be used with Validatem, the universal and composable validation library.
Validates that a given input is a string.
Note that it __does not__ validate that the string is non-empty (ie. has a length above 0); for that, you should use @validatem/is-non-empty-string instead.
Licensed under either the WTFPL or CC0, at your choice. In practice, that means it's more or less public domain, and you can do whatever you want with it. Giving credit is not required, but still very much appreciated! I'd love to hear from you if this module was useful to you.
Creating and maintaining open-source modules is a lot of work. A donation is also not required, but much appreciated! You can donate here.
A runnable version of this example is included in the repository, as example.js.
``js
"use strict";
const { validateValue } = require("@validatem/core");
const isString = require("@validatem/is-string");
console.log(validateValue("hello world", [ isString ])); // hello world
console.log(validateValue(42, [ isString ])); /*
AggregrateValidationError: One or more validation errors occurred:
- At (root): Must be a string
*/
``
__If you are new to Validatem,__ please read the documentation on the Validatem website first - it will explain how the general API works, and how you should use validator modules with it.
Not callable. Validates that the input is a string. When validation passes, it returns the original string as-is.
Possible error codes:
- __validatem.is-string:__ The input was not a string.
Fixed internal typo.
__BREAKING:__ Replace internal string checking implementation with a faster one; the new implementation will not recognize String objects from another realm (but will still work fine with regular, non-object strings).
You most likely don't need to change anything about your code, but this is still considered a breaking change because it slightly changes the behaviour of the validator.
Initial release.