JavaScriptでCookieの有効期限が切れているかどうかを判定する方法

Webアプリケーションを開発していると、「特定のCookieがまだ有効か、それとも期限切れで消えてしまったか」を確認したくなる場面があります。ここでは、jQuery Cookieプラグインを使用してCookieの有効期限切れを判定する方法を解説します。

Cookieの有効期限切れを判定する基本的な方法

jQuery Cookieプラグイン（$.cookie）では、指定したCookieが存在しない、またはすでに有効期限が切れている場合にnullを返します。この仕組みを利用して、次のように条件分岐を記述します。

if (!($.cookie('myCookie') === null)) {
    // Cookieが存在する場合の処理
} else {
    // Cookieが有効期限切れの場合の処理
}

このコードでは、$.cookie('myCookie') の戻り値がnullでなければCookieが有効、nullであれば期限切れと判断して処理を振り分けています。

三項演算子で1行にまとめる方法

より簡潔に書きたい場合は、三項演算子（条件演算子）を使えば、判定と処理を1行で表現できます。

checkCookie = $.cookie('myCookie') === null ?
    ( /* 条件がTRUEの場合の処理：Cookieが期限切れ */ ) :
    ( /* 条件がFALSEの場合の処理：Cookieが存在 */ );

実装時の注意点

• プラグインが必要： $.cookie() はjQuery Cookieプラグイン（jquery.cookie.js / js-cookie）のメソッドです。jQuery本体を読み込むだけでは使用できず、別途プラグインファイルが必要です。
• null以外の返り値： 環境によっては、存在しないCookieに対してundefinedが返るケースもあります。「== null」という緩い比較を使えば、nullとundefinedの両方をカバーできて安全です。
• 文字列として保存される値： Cookieには文字列しか保存されません。値が空文字列の場合など、意図しない挙動になることもあるため、必要に応じて値の中身も確認しましょう。

プラグインを使わずネイティブJavaScriptで判定する方法

外部ライブラリに依存したくない場合は、標準の document.cookie を使って判定することもできます。document.cookie にはすべてのCookieが「名前=値」の形式で連結された文字列として格納されています。

function hasCookie(name) {
    return document.cookie.split('; ').some(function(item) {
        return item.startsWith(name + '=');
    });
}

if (hasCookie('myCookie')) {
    // Cookieが存在する場合の処理
} else {
    // Cookieが有効期限切れの場合の処理
}

このように、jQuery Cookieプラグインを使ったシンプルなnullチェックから、ネイティブJavaScriptによる判定まで、目的や環境に合わせた方法を選択できます。