JSON → Mongoose スキーマ

JSONからMongooseスキーマを即座に生成。JavaScript・TypeScript出力、timestamps、ネストオブジェクト・配列対応。無料、ブラウザ内で処理。

  • ブラウザ内で処理
  • ツールの入力を ZeroTool のサーバーにアップロードしません
  • 無料 · 登録不要
モデルとルートスキーマの名前です。空欄では User を使います。User や Order などの単純な名前を推奨します。
言語 JavaScript は CommonJS require と module.exports を使います。TypeScript は import/export を使い、ドキュメントのインターフェースを Schema と model に渡します。
timestamps オンではルートスキーマに timestamps: true を付けます。TypeScript は createdAt と updatedAt を Date 型として追加します。JSON に同名キーがある場合は元の型を保持します。
必須フィールド オンではプリミティブ、日付、Mixed、プリミティブ配列に required: true を付けます。ネストしたスキーマとオブジェクト配列は元の形式を保持します。
JSON をネストしたオブジェクトと配列を含むユーザー文書に置き換え、現在のモデル名と設定ですぐに生成します。
JSON、出力、ステータスを消去し、モデル名と設定を保持します。ツール内の Ctrl/⌘+L はモデル名も消去します。
有効な JSON を入力します。JSON とモデル名の編集から 300 ミリ秒後に生成します。3 つの設定は即時反映されます。無効な JSON では出力を消去してコピーを無効にします。
Mongoose スキーマ出力
表示中のスキーマと model のエクスポートを全文コピーします。出力が空の場合はコピーを無効にします。

JSON を入力するかサンプルを読み込むと、Mongoose スキーマを生成します。

例・詳しい説明・よくある質問 実際の出力つきの例、ほかのツールとの違い、よくある質問。

型マッピング

  • null はどの型にも入るので推論では読み飛ばします。すべてのサンプルで null のフィールド → mongoose.Schema.Types.Mixed
  • サンプルごとに型が違うフィールド(数値と文字列、オブジェクトと文字列)→ mongoose.Schema.Types.Mixed。ISO 日時とほかの文字列が混ざる場合 → String
  • ISO 8601 の日時で始まる文字列(2026-10-01T09:30:00Z)→ Date。日付だけの 2026-10-01、T の代わりに空白を入れた 2026-10-01 09:30:00、配列の中の日時は String のまま
  • 文字列 → String
  • 数値 → Number
  • 真偽値 → Boolean
  • プリミティブ配列 → [String] / [Number] / [Boolean]
  • オブジェクト配列 → [subSchema](独立サブスキーマを生成)
  • ネストオブジェクト → 独立スキーマ変数をインライン参照

例

モデル名 User、以下のJSONを入力した場合:

{"username": "alice", "age": 28, "tags": ["admin"], "address": {"city": "London"}}

JavaScript出力(timestampsオン):

const mongoose = require('mongoose');
const { Schema } = mongoose;

const addressSchema = new Schema({
  city: { type: String },
});

const userSchema = new Schema({
  username: { type: String },
  age: { type: Number },
  tags: [String],
  address: addressSchema,
}, { timestamps: true });

module.exports = mongoose.model('User', userSchema);

例:すべてのサンプルで型を決める

注文 2 件のルート配列、モデル名 Order、JavaScript、timestamps オフ:

[{"code":1,"note":null,"seller":{"meta":{"x":1}},"buyer":{"meta":{"y":"2"}}},{"code":"A-2","note":"gift","tags":["a",1]}]

出力:

const mongoose = require('mongoose');
const { Schema } = mongoose;

const metaSchema = new Schema({
x: { type: Number },
});

const sellerSchema = new Schema({
meta: metaSchema,
});

const buyerMetaSchema = new Schema({
y: { type: String },
});

const buyerSchema = new Schema({
meta: buyerMetaSchema,
});

const orderSchema = new Schema({
code: { type: mongoose.Schema.Types.Mixed },
note: { type: String },
seller: sellerSchema,
buyer: buyerSchema,
tags: [mongoose.Schema.Types.Mixed],
}, { timestamps: false });

module.exports = mongoose.model('Order', orderSchema);
  • code は 1 件目が 1、2 件目が "A-2" なので Mixed です。Number だと "A-2" を拒否します。note は null と "gift" なので String です。tags は文字列と数値が混ざるので要素が Mixed です。
  • 2 つの meta はフィールドが違うので、2 つ目は親のキーを前に付けます(buyerMetaSchema)。同じキーでフィールドと型が同じオブジェクトは 1 つのスキーマを共有します。親のキーを付けても名前が重なるときは番号を付けます。

ツールのテストでは、生成した JavaScript を Mongoose 9.10.3 で実行し、各サンプルからドキュメントを作って validateSync() が通ること、すべてのフィールドと値が残ることを確認しています(ISO 日時は Date になり、toISOString() の形で比較。サンプルにない配列フィールドは Mongoose の既定値 [] になります)。

気象庁の天気予報 JSON から作る

気象庁が公開している天気予報の JSON(東京都は https://www.jma.go.jp/bosai/forecast/data/forecast/130000.json)を、取得した予報をそのまま保存するコレクションのスキーマを下書きする例です。2026 年 10 月 8 日 17 時発表分から東京地方だけを取り出し、天気の時系列は 3 時点すべて、降水確率の時系列は最初の 2 時点だけを残しました(値は発表時のまま。モデル名 forecast、TypeScript、timestamps オフ):

[{"publishingOffice":"気象庁","reportDatetime":"2026-10-08T17:00:00+09:00","timeSeries":[{"timeDefines":["2026-10-08T17:00:00+09:00","2026-10-09T00:00:00+09:00","2026-10-10T00:00:00+09:00"],"areas":[{"area":{"name":"東京地方","code":"130010"},"weatherCodes":["100","100","101"],"weathers":["晴れ","晴れ","晴れ 時々 くもり"]}]},{"timeDefines":["2026-10-08T18:00:00+09:00","2026-10-09T00:00:00+09:00"],"areas":[{"area":{"name":"東京地方","code":"130010"},"pops":["0","0"]}]}]}]

出力:

import mongoose, { Schema } from 'mongoose';

export interface IArea {
name: string;
code: string;
}

export interface IAreas {
area: IArea;
weatherCodes: string[];
weathers: string[];
pops: string[];
}

export interface ITimeSeries {
timeDefines: string[];
areas: IAreas[];
}

export interface IForecast {
publishingOffice: string;
reportDatetime: Date;
timeSeries: ITimeSeries[];
}

const areaSchema = new Schema({
name: { type: String },
code: { type: String },
});

const areasSchema = new Schema({
area: areaSchema,
weatherCodes: [String],
weathers: [String],
pops: [String],
});

const timeSeriesSchema = new Schema({
timeDefines: [String],
areas: [areasSchema],
});

const forecastSchema = new Schema<IForecast>({
publishingOffice: { type: String },
reportDatetime: { type: Date },
timeSeries: [timeSeriesSchema],
}, { timestamps: false });

export default mongoose.model<IForecast>('Forecast', forecastSchema);
  • 天気の時系列と降水確率(pops)の時系列は areas の形が違いますが、どちらも timeSeries の要素なので 1 つの areasSchema にまとめられ、weatherCodes・weathers・pops がすべて入ります。インターフェースではどれも必須の形なので、片方の時系列にしかないものには ? を付けてください。
  • reportDatetime は +09:00 付きの ISO 日時なので Date になります。MongoDB の日付は時刻の一点だけを記録し、タイムゾーンを持ちません(Mongoose: Working With Dates)。保存後に読むと 2026-10-08T08:00:00.000Z になるので、日本時間で表示するときは表示側で変換します。
  • timeDefines は同じ形の日時ですが、配列の中なので [String] です。時刻で検索するなら [Date] に書き換えます。
  • 降水確率は "0" のように文字列で入っているので [String] です。数値として集計するなら、保存前に変換するか [Number] に変えて Mongoose に変換させます。

制限

  • Mixed は何でも受け入れます。サンプルの型がそろわず Mixed になったフィールドは型変換も検証もされず、中を変更したときは markModified() を呼ばないと Mongoose が保存しません。データが許すなら 1 つの型にしてください。
  • Date になる書き方は 1 つです。YYYY-MM-DDThh:mm:ss で始まる文字列だけが Date になります。データベースから書き出した 2026-10-08 09:30:00 のような空白区切りは String のままです。
  • ルート配列はオブジェクトだけを見ます。スキーマはドキュメントを表すので、オブジェクトと並ぶ数値・文字列・null・配列はスキーマに入れず、何個あってどの JSON 型だったかをステータス行に出します(例:ルート配列のうちオブジェクトでない 5 個の値はスキーマに入れていません(number × 2, string, null, array)。)。すべてプリミティブならスキーマは作らず、コメント // Array of primitives — no schema to generate だけを出します。
  • 予約済みのパス名は警告付きで残ります。Mongoose 9.10.3 は collection, emit, errors, get, init, isModified, isNew, listeners, populated, remove, removeListener, save, toObject, validate を予約名としています(lib/schema.js の Schema.reserved)。このキーもパスとして残り、値も保存されますが、Mongoose は警告を出します。また、ドキュメントでは同名のメソッドやプロパティ(errors、isNew はプロパティ)の代わりにフィールドの値が返ります。save というフィールドがあると doc.save はその値になり、doc.save() は失敗します。ステータス行にこれらのキーを出します。get と toObject はドキュメントを壊すこともあるため、次のグループに出します。スキーマオプション suppressReservedKeysWarning は警告を消すだけなので、ツールは付けません。キー名を変えてください。
  • ほかのドキュメントメンバー名でもドキュメントが壊れることがあります。Mongoose が警告するのは予約名だけですが、ドキュメントのメンバーはほかにもあります。ツールは各キーを Mongoose 9.10.3 のドキュメントのメンバーと照らし合わせ、ステータス行に 2 つのグループを出します。1 つ目は Mongoose 自身が使うドキュメントメンバー(メソッドやプロパティ)の名前で、フィールド名に使うとドキュメントの作成・検証・シリアライズが失敗することがあり、ステータス行は警告色になります。markModified というフィールドがあると new Model() が this.markModified is not a function を投げ、_doc では Maximum call stack size exceeded になります。schema は入力がスキーマ内のキーだけなら動きますが、ほかのキーがあると Cannot read properties of undefined (reading 'discriminatorKey') で失敗します。toJSON があると JSON.stringify(doc) が Mongoose の内部状態($__、_doc)を出力します。このグループは _doc、__index、__parentArray、get、isDirectModified、markModified、modifiedPaths、schema、toBSON、toJSON、toObject、validateSync と、$ で始まる 29 個の名前です(get と toObject は予約名でもあります)。ほかの 83 個の名前には Mongoose は警告を出さず、同名のメソッドやプロパティの代わりにフィールドの値が返るだけです。model と set というフィールドがあると、doc.model と doc.set はフィールドの値になります。ツールのテストは実際の Mongoose 9.10.3 のドキュメントから両方のグループを作り直しています。キー名を変えてください。
  • パスにならないキー名が 3 つあります。Mongoose 9.10.3 はスキーマを作るときに __proto__・constructor・prototype というキーを読み飛ばします(lib/schema.js。プロトタイプ汚染対策)。出力にはこれらのキーも残し、__proto__ はオブジェクトリテラルがプロトタイプとして扱わないよう ["__proto__"] と書き、ステータス行にキー名を出します。保存する前にキー名を変えてください。
  • ObjectId・enum・インデックス・検証は作りません。24 文字の 16 進文字列も String です。Schema.Types.ObjectId と ref、unique、enum、min/max は自分で足してください。
  • 日本語のキーは引用符付きで残ります。"住所" のようにパスとしてはそのまま使えますが、スキーマ変数名は ASCII だけで作るため fieldSchema になります。わかる名前に付け替えてください。
  • 型引数はルートスキーマだけです。サブスキーマの new Schema() には型引数がなく、「必須フィールド」がオフでもインターフェースのフィールドに ? は付きません。Mongoose はインターフェースとスキーマが合っているか確かめないので、任意のフィールドには自分で ? を付けます。

FAQ

このツールは何を生成しますか?

JSONからMongooseスキーマ定義を生成します。ネストしたオブジェクトはサブスキーマになり、それを使うスキーマより前に書かれます(同じキーでフィールドと型が同じオブジェクトは1つを共有)。末尾にmodelのエクスポート文が付きます。

対応言語モードは何ですか?

JavaScript(CommonJS require/module.exports)とTypeScript(ES module import/export)です。TypeScript出力はMongooseのTypeScriptガイドの書き方に従い、Documentを継承しない通常のドキュメントインターフェースをSchema<T>とmodel<T>に渡します。

JSON型はMongoose型にどう対応しますか?

string→String、ISO 8601 の日時で始まる文字列(2026-10-01T09:30:00Z など)→Date、number→Number、boolean→Boolean、すべてのサンプルが null か、サンプルごとに型が違うフィールド→mongoose.Schema.Types.Mixed、プリミティブ配列→[Type](配列内の日時は String のまま)、null を含まないオブジェクト配列→[サブスキーマ]、ネストオブジェクト→サブスキーマ。

timestampsオプションの効果は?

オンにすると{ timestamps: true }でスキーマが作成され、MongooseがcreatedAtとupdatedAtフィールド(Date型)を自動管理します。TypeScriptモードではインターフェースにもcreatedAt: DateとupdatedAt: Dateが入ります。JSONのルートに同名のキーがある場合は、そのキーの型を残します。

フィールドはrequiredになりますか?

既定ではなりません。JSONのサンプルだけでは必須かどうか判断できないためです。「必須フィールド」をオンにすると、ネストしたスキーマとオブジェクト配列以外のすべてのフィールドに required: true が付くので、任意のフィールドから外してください。Mongoose の required は null を通さないため、サンプルで null だったフィールドは required のままにできません。

データはサーバーに送信されますか?

いいえ。JSON とモデル名はこのブラウザのタブの中で処理され、送信されません。ブラウザのストレージにも保存しません。入力を編集してフォーカスを外したとき、サンプルをクリックしたとき、設定を切り替えたときに、ツール名と操作名(generate)だけの統計イベントを記録します。直前に記録したときと JSON・モデル名・設定が同じ場合は記録しません。