JavaScriptで文字列が半角英数字記号であるかを正規表現でチェックする
文字列が半角英数字記号であるかを正規表現でチェックするには「^[ -~]+$」のパターンを使います。この正規表現は「1文字以上の半角英数字記号の組み合わせで構成される文字列」という意味になり「Hello, world!」などの文字列にマッチします。半角スペースを除外したい場合は「^[!-~]+$」とパターンを記述します。
また「^[ -~]{6}$」のパターンは6桁の半角英数字記号にマッチするのでクーポンコードなど固定長文字列の入力チェックに利用できます。パスワードなどで12桁以上20桁以下の半角英数字記号にマッチさせたい場合は「^[ -~]{12,20}$」とパターンを記述することができます。
基本的な半角英数字記号チェックで利用できる正規表現のパターンは以下になります。
# | マッチさせたい条件 | 正規表現パターン |
---|---|---|
1 | すべて半角英数字記号である | ^[ -~]+$ |
2 | n桁の半角英数字記号である | ^[ -~]{n}$ |
3 | n桁以上の半角英数字記号である | ^[ -~]{n,}$ |
4 | m桁以下の半角英数字記号である | ^[ -~]{1,m}$ |
5 | n桁以上m桁以下の半角英数字記号である | ^[ -~]{n,m}$ |
ソースコード
n桁の半角英数字記号であるかをチェックする
/**
* 文字列が指定した桁数の半角英数字記号かチェックします
*
* @param {string} str チェック対象の文字列
* @param {number} len 桁数
* @returns {boolean} 文字列が指定した桁数の半角英数字記号の場合はtrue、それ以外はfalse
*/
const isHalfWidthAlphanumericSymbolsFixedLength = (str, len) => {
if (len < 0) {
throw new Error("桁数は0以上の整数である必要があります。");
}
const regex = new RegExp(`^[ -~]{${len}}$`, "u");
return regex.test(str);
};
検証
検証結果
n桁以上の半角英数字記号であるかをチェックする
/**
* 文字列が最小桁数以上の半角英数字記号かチェックします
*
* @param {string} str チェック対象の文字列
* @param {number} minLength 最小桁数
* @returns {boolean} 文字列が最小桁数以上の半角英数字記号の場合はtrue、それ以外はfalse
*/
const isHalfWidthAlphanumericSymbolsAtLeastMinLength = (str, minLength) => {
if (minLength < 0) {
throw new Error("最小桁数は0以上の整数である必要があります。");
}
const regex = new RegExp(`^[ -~]{${minLength},}$`, "u");
return regex.test(str);
};
検証
検証結果
m桁以下の半角英数字記号であるかをチェックする
/**
* 文字列が最大桁数以下の半角英数字記号かチェックします
*
* @param {string} str チェック対象の文字列
* @param {number} maxLength 最大桁数
* @returns {boolean} 文字列が最大桁数以下の半角英数字記号の場合はtrue、それ以外はfalse
*/
const isHalfWidthAlphanumericSymbolsAtMostMaxLength = (str, maxLength) => {
if (maxLength < 1) {
throw new Error("最大桁数は1以上の整数である必要があります。");
}
const regex = new RegExp(`^[ -~]{1,${maxLength}}$`, "u");
return regex.test(str);
};
検証
検証結果
n桁以上m桁以下の半角英数字記号であるかをチェックする
/**
* 文字列が指定した桁数範囲の半角英数字記号かチェックします
*
* @param {string} str チェック対象の文字列
* @param {number} minLength 最小桁数
* @param {number} maxLength 最大桁数
* @returns {boolean} 文字列が最小桁数以上の半角英数字記号の場合はtrue、それ以外はfalse
*/
const isHalfWidthAlphanumericSymbolsInRange = (str, minLength, maxLength) => {
if (minLength < 0) {
throw new Error("最小桁数は0以上の整数である必要があります。");
}
if (maxLength < 1) {
throw new Error("最大桁数は1以上の整数である必要があります。");
}
if (maxLength < minLength) {
throw new Error("最小桁数と最大桁数が逆転しています。");
}
const regex = new RegExp(`^[ -~]{${minLength},${maxLength}}$`, "u");
return regex.test(str);
};