Skip to content

isString

値が文字列型かどうかを判定します。

API

isString

戻り値

引数説明
boolean文字列かどうかboolean

パラメーター

パラメーター説明既定値
obj調べる値unknown必須

使用例

基本的な使い方

js
import { isString } from 'ranuts';

console.log(isString('hello')); // true
console.log(isString(123)); // false
console.log(isString(null)); // false
console.log(isString(undefined)); // false

型のチェック

js
import { isString } from 'ranuts';

function processValue(value) {
  if (isString(value)) {
    console.log('文字列です:', value.toUpperCase());
  } else {
    console.log('文字列ではありません');
  }
}

processValue('hello'); // '文字列です: HELLO'
processValue(123); // '文字列ではありません'

引数の検証

js
import { isString } from 'ranuts';

function validateInput(input) {
  if (!isString(input)) {
    throw new Error('入力は文字列でなければなりません');
  }
  return input.trim();
}

補足

  1. 型の判定Object.prototype.toString.call() を使って正確に型を見分けます。
  2. 厳しさ:値が本当の文字列型のときだけ true を返します。ほかの型(String オブジェクトを含む)は false です。
  3. 使いどころ:型のチェックや引数の検証などでよく使われます。

MIT ライセンスのもとで公開されています。