作り方
JavaScriptでハイスコアを保存する方法|localStorageの使い方【コピペで動く】
※この記事にはプロモーション(広告)が含まれます。
この記事の結論
localStorageは、ブラウザを閉じても残る小さな保存場所- 使うのは
setItem(保存)・getItem(読み出し)・removeItem(削除)の3つ - 値は文字で保存される。読み出したら
Number()で数字に。保存がないとnull - 「まだ記録がない」と「0」を分けたいときは、
nullかどうかで分ける - 複数の値は
JSON.stringify/JSON.parseでまとめて保存 try...catchで囲んで、保存できなくてもゲームが止まらないようにする
ブラウザゲームを作ると、「ハイスコアを残したい」「音のオン・オフを覚えておきたい」と思うことがあります。でも、ふつうに変数に入れただけでは、ページを閉じたり再読み込みしたりすると消えてしまいます。
そこで使うのが localStorage です。kakapo studio で公開しているゲーム(カカポの森のブロック崩し・カカポを育てる地名タイピング・熱闘天敵バスターズ)も、ハイスコアや進み具合を localStorage に保存しています。この記事では、その実際のコードを例に、使い方をまとめます。最後に、コピペで動く小さなゲームのコードもあります。
完成するもの
5秒の間に、ボタンを何回押せるかを数える小さなゲームです。ハイスコアを更新すると保存され、ページを再読み込みしても、ブラウザを閉じても残ります。
ハイスコアを出したら、再読み込みしてみてください。「記録を消す」で、保存したハイスコアを消せます。
localStorage とは
localStorage は、ブラウザの中にある小さな保存場所です。保存したデータには期限がなく、ブラウザを閉じても残ります。
- サイト(オリジン)ごとに分かれている:別のサイトが保存したものは読めない。
httpとhttpsも別あつかい - そのブラウザの中だけ:同じゲームでも、別のブラウザや別の端末とは共有されない
似たものに sessionStorage があります。こちらは、タブやウィンドウを閉じると消えます(再読み込みでは消えません)。ハイスコアのように長く残したいものは localStorage を使います。
なお、プライベートウィンドウ(シークレットモード)で保存したものは、最後のプライベートタブを閉じると消えます。
基本の3つ:保存・読み出し・削除
使うのは、次の3つだけです。
// 保存する(キー と 値)
localStorage.setItem("my-game-high", "120");
// 読み出す(なければ null)
const value = localStorage.getItem("my-game-high");
// 削除する
localStorage.removeItem("my-game-high");
キーは、保存するものの名前です。同じサイトにゲームがいくつもあるときは、名前がぶつからないように、頭をそろえておくとわかりやすくなります。kakapo studio のゲームでは、次のような名前にしています。
| ゲーム | キー | 保存しているもの |
|---|---|---|
| カカポの森のブロック崩し | kakapo-block-high | ハイスコア |
| カカポの森のブロック崩し | kakapo-block-muted | 音のオン・オフ |
| カカポを育てる地名タイピング | kakapo-typing-best-1・kakapo-typing-best-2 | レベルごとのベストタイム |
| 熱闘天敵バスターズ | tenteki-busters-save | 遊べるステージ数と最長飛距離 |
| 熱闘天敵バスターズ | tenteki-busters-muted | 音のオン・オフ |
数字は「文字」で保存される
localStorage には、キーも値も文字(文字列)で保存されます。120 という数字を入れても、取り出すと "120" という文字になっています。また、まだ何も保存していないキーを getItem すると null が返ってきます。
そこで、読み出したら数字に直します。直し方は、「まだ記録がない」と「0」を分けたいかどうかで変わります。
分けなくてよい:ブロック崩しのハイスコア
block-game/script.js(ハイスコアの読み出しと保存)
// ===== ハイスコア(ブラウザに保存) =====
function loadHighScore() {
try {
return Number(localStorage.getItem("kakapo-block-high")) || 0;
} catch (e) {
return 0;
}
}
function saveHighScore() {
try {
localStorage.setItem("kakapo-block-high", String(highScore));
} catch (e) {
// 保存できなくても気にしない
}
}
Number(...) で文字を数字に直しています。まだ保存がないとき(null)は Number(null) が 0 になり、読めない文字が入っていたときは NaN(数字ではない、という値)になります。NaN は || で「なかったもの」とあつかわれるので、どちらの場合も 0 になります。ハイスコアは「まだ記録がない」も「0点」も同じ表示でよいので、この短い書き方で足ります。
分けたい:地名タイピングのベストタイム
typing-game/script.js(ベストタイムの読み出しと保存)
// ===== ベストタイム(ブラウザに保存) =====
// localStorage は、ブラウザを閉じても残る小さな保存場所
function loadBest(lv) {
try {
const value = localStorage.getItem("kakapo-typing-best-" + lv);
return value === null ? null : Number(value);
} catch (e) {
return null; // 保存が使えない環境でも、ゲームは遊べるようにする
}
}
function saveBest(lv, ms) {
try {
localStorage.setItem("kakapo-typing-best-" + lv, String(ms));
} catch (e) {
// 保存できなくても気にしない
}
}
タイムは短いほうがよい記録なので、「まだ記録がない」を 0 にしてしまうと、「0秒」という最強の記録があることになってしまいます。そこで、保存がないときは null のまま返しています。
保存するときは、次のように「まだ記録がない」か「前より速い」ときだけ保存します。
// ベストタイムは、全問正解(おとなのカカポ)のときだけ記録する
const best = loadBest(level);
const isNewRecord = correct === QUESTION_COUNT && (best === null || elapsed < best);
if (isNewRecord) {
saveBest(level, elapsed);
}
複数の値をまとめて保存する(JSON)
熱闘天敵バスターズでは、「遊べるステージ数」と「最長飛距離」の2つを、1つのキーにまとめて保存しています。
tenteki-busters/script.js(進み具合の読み出しと保存)
// ===== 進み具合(ブラウザに保存) =====
function loadSave() {
try {
const data = JSON.parse(localStorage.getItem("tenteki-busters-save"));
if (data && data.unlocked) {
return data;
}
} catch (e) {
// 保存が使えない環境でも気にしない
}
return { unlocked: 1, best: 0 };
}
function writeSave() {
try {
localStorage.setItem("tenteki-busters-save", JSON.stringify(save));
} catch (e) {
// 保存できなくても気にしない
}
}
- 保存:
JSON.stringify(save)で、{ unlocked: 2, best: 105 }のようなまとまりを文字にしてから保存します。JSON.stringifyを使わずにそのまま入れると、"[object Object]"という文字になってしまい、中身が残りません - 読み出し:
JSON.parse(...)で、文字をまとまりに戻します - まだ保存がないとき:
getItemがnullを返すと、JSON.parseの結果もnullになります。するとifの中に入らず、いちばん下の初期値(ステージ1だけ遊べる・記録0)が使われます - 中身がこわれていたとき:
JSON.parseは、正しい形でない文字を読むとエラーを出します。そのエラーはcatchで受け止めて、やはり初期値が使われます
保存できないときに止まらないように(try...catch)
ここまでのコードは、どれも try { ... } catch (e) { ... } で囲んでいます。localStorage は、いつでも使えるとは限らないからです。
- 容量がいっぱいのとき:
setItemがエラー(QuotaExceededError)を出すことがあります。MDN では、setItemのエラーはいつも受け止めるように書かれています - 保存が許可されていないとき:ユーザーがサイトのデータ保存を拒否している設定のときや、ファイルを
file:などで開いたときに、localStorageにさわっただけでエラー(SecurityError)になることがあります
エラーを受け止めないと、そこでプログラムが止まり、ゲームそのものが動かなくなることがあります。try...catch で囲んでおけば、保存できなくても「記録が残らないだけ」で、ゲームは遊べます。
音のオン・オフの保存も同じ形です。ブロック崩しでは、"1"(音なし)か "0"(音あり)を保存しています。
block-game/sound.js(音のオン・オフの読み出し)
try {
muted = localStorage.getItem("kakapo-block-muted") === "1";
} catch (e) {
// 保存が使えない環境でも気にしない
}
block-game/sound.js(音のオン・オフの保存)
function setMuted(value) {
muted = value;
try {
localStorage.setItem("kakapo-block-muted", value ? "1" : "0");
} catch (e) {
// 保存できなくても気にしない
}
}
効果音そのものの作り方は、音声ファイルなしで効果音を作る方法にまとめています。
完成コード:ハイスコアを保存する小さなゲーム
上のデモと同じコードです。メモ帳などに貼り付けて、tap-game.html という名前(文字コードは UTF-8)で保存すると動きます。
tap-game.html
<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>5秒で何回押せる?(ハイスコア保存つき)</title>
<style>
body { font-family: sans-serif; text-align: center; padding: 40px 16px; }
#score { font-size: 64px; margin: 8px 0; font-variant-numeric: tabular-nums; }
#message { min-height: 1.5em; color: crimson; }
button { font-size: 18px; padding: 10px 20px; margin: 4px; }
#tap { font-size: 24px; padding: 20px 48px; }
</style>
</head>
<body>
<h1>5秒で何回押せる?</h1>
<p>ハイスコア:<span id="high">0</span></p>
<p id="score">0</p>
<p id="message"></p>
<p><button id="tap">スタート</button></p>
<p><button id="reset">記録を消す</button></p>
<script>
const KEY = "my-tap-game-high"; // 保存に使う名前(キー)
const TIME = 5000; // 1回の長さ(ミリ秒)
const highText = document.getElementById("high");
const scoreText = document.getElementById("score");
const message = document.getElementById("message");
const tapButton = document.getElementById("tap");
let score = 0;
let playing = false;
let lockedUntil = 0; // 終わった直後に、押しすぎで次が始まらないように
let highScore = loadHighScore();
highText.textContent = highScore;
// 読み出す:まだ保存がないとき(null)や、読めないときは 0
function loadHighScore() {
try {
return Number(localStorage.getItem(KEY)) || 0;
} catch (e) {
return 0; // 保存が使えない環境でも、ゲームは遊べるようにする
}
}
// 保存する:数字は文字にしてから入れる
function saveHighScore() {
try {
localStorage.setItem(KEY, String(highScore));
} catch (e) {
// 保存できなくても、ゲームは止めない
}
}
function finish() {
playing = false;
lockedUntil = Date.now() + 1000;
tapButton.textContent = "もう一度";
if (score > highScore) {
highScore = score;
highText.textContent = highScore;
saveHighScore();
message.textContent = "ハイスコア更新!";
} else {
message.textContent = "おしい!";
}
}
tapButton.addEventListener("click", () => {
if (Date.now() < lockedUntil) return;
if (!playing) {
playing = true;
score = 0;
scoreText.textContent = score;
message.textContent = "";
tapButton.textContent = "押す!";
setTimeout(finish, TIME);
return;
}
score++;
scoreText.textContent = score;
});
document.getElementById("reset").addEventListener("click", () => {
try {
localStorage.removeItem(KEY);
} catch (e) {
// 消せなくても気にしない
}
highScore = 0;
highText.textContent = highScore;
message.textContent = "記録を消しました";
});
</script>
</body>
</html>
ファイルをダブルクリックして開いたとき(file:)の localStorage の動きは、ブラウザによってちがいます。保存されないときは、デモのページで試すか、作ったゲームをWebに公開してから試してください(GitHub Pagesでブラウザゲームを無料公開する方法)。try...catch で囲んでいるので、保存できない場合でもゲームは遊べます。
5秒を数えるのは setTimeout だけの簡単な形にしています。時間を正確に数える方法は、JavaScriptでタイマーを作る方法にまとめています。
使うときの注意点
- パスワードや個人情報は入れない:
localStorageの中身は、そのページの JavaScript からいつでも読めます。OWASP(Webのセキュリティの団体)は、大事な情報やログインのための情報を入れないように呼びかけています。ハイスコアや設定のような、見られても困らないものだけにしましょう - ほかのブラウザ・端末とは共有されない:スマホで出したハイスコアは、パソコンでは見えません
- 消えることがある:ユーザーがブラウザのサイトデータを消すと、いっしょに消えます。プライベートウィンドウでは、閉じると消えます
- 容量には上限がある:ブラウザやサイト(オリジン)ごとに上限があります。ハイスコアや設定くらいなら気にしなくて大丈夫ですが、大きなデータには向きません
まとめ
localStorageは、ブラウザを閉じても残る小さな保存場所- 使うのは
setItem(保存)・getItem(読み出し)・removeItem(削除)の3つ - 値は文字で保存される。読み出したら
Number()で数字に。保存がないとnull - 「まだ記録がない」と「0」を分けたいときは、
nullかどうかで分ける - 複数の値は
JSON.stringify/JSON.parseでまとめて保存 try...catchで囲んで、保存できなくてもゲームが止まらないようにする
ゲームの画面を動かす基本はcanvasで絵を動かす基本、ブロック崩しのほかのしくみはブロック崩しの当たり判定の作り方、地名タイピングのしくみはタイピングゲームのローマ字判定の作り方にまとめています。

