JSON → Mongoose スキーマ
JSONからMongooseスキーマを即座に生成。JavaScript・TypeScript出力、timestamps、ネストオブジェクト・配列対応。無料、ブラウザ内で処理。
- ブラウザ内で処理
- ツールの入力を ZeroTool のサーバーにアップロードしません
- 無料 · 登録不要
WeChat でスキャンしてシェア
例・詳しい説明・よくある質問 実際の出力つきの例、ほかのツールとの違い、よくある質問。
型マッピング
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・モデル名・設定が同じ場合は記録しません。