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, 다른 건이"A-2"라서Mixed입니다.Number면"A-2"를 거부합니다.note는null과"gift"라서String입니다.tags는 문자열과 숫자가 섞여 요소가Mixed입니다.- 두
meta는 필드가 달라서 두 번째에 부모 키를 앞에 붙입니다(buyerMetaSchema). 같은 키에서 필드와 타입이 같은 객체는 스키마 하나를 함께 씁니다. 앞에 붙여도 이름이 겹치면 번호를 붙입니다.
도구 테스트는 생성된 JavaScript를 Mongoose 9.10.3으로 실행해 샘플마다 문서를 만들고, validateSync()가 통과하는지와 모든 필드·값이 남는지 확인합니다(ISO 날짜·시간은 Date가 되어 toISOString() 형태로 비교. 샘플에 없는 배열 필드는 Mongoose 기본값 []가 됩니다).
한글 키 주문 데이터와 한국 시간
쇼핑몰 관리자 페이지에서 내려받은 주문을 MongoDB로 그대로 옮길 때처럼, 키가 한글인 데이터의 예입니다. 모델 이름 order, JavaScript, timestamps 켜짐, 필수 필드 켜짐:
{"주문번호":"20261008-0001","주문일시":"2026-10-08T09:30:00+09:00","배송지":{"우편번호":"04524","주소":"서울특별시 중구 세종대로 110"},"상품":[{"상품명":"무선 마우스","수량":1,"가격":29000},{"상품명":"마우스 패드","수량":2,"가격":5000}]}
출력:
const mongoose = require('mongoose');
const { Schema } = mongoose;
const fieldSchema = new Schema({
"우편번호": { type: String, required: true },
"주소": { type: String, required: true },
});
const orderFieldSchema = new Schema({
"상품명": { type: String, required: true },
"수량": { type: Number, required: true },
"가격": { type: Number, required: true },
});
const orderSchema = new Schema({
"주문번호": { type: String, required: true },
"주문일시": { type: Date, required: true },
"배송지": fieldSchema,
"상품": [orderFieldSchema],
}, { timestamps: true });
module.exports = mongoose.model('Order', orderSchema);
- 한글 키는 따옴표로 감싸 경로 이름 그대로 남기므로 생성된 파일은 바로 실행됩니다. 변수 이름은 ASCII로만 만들기 때문에
배송지의 서브스키마는fieldSchema, 필드가 다른상품요소는 모델 이름을 앞에 붙여orderFieldSchema가 됩니다. 커밋 전에shippingSchema,itemSchema처럼 알아볼 수 있는 이름으로 바꾸세요. - 필수 필드를 켜도
배송지와상품자체에는required가 붙지 않고, 그 안의 필드에만 붙습니다. 주문일시는+09:00이 붙은 ISO 날짜·시간이라Date입니다. MongoDB 날짜는 시각 하나만 기록하고 시간대를 저장하지 않으므로(Mongoose: Working With Dates) 저장 후 읽으면2026-10-08T00:30:00.000Z입니다. 한국 시간으로 보여 줄 때는 화면 쪽에서 변환합니다.우편번호04524는 문자열이라String이 되고 앞의 0이 남습니다. JSON 숫자는 앞자리에 0을 쓸 수 없으므로(RFC 8259 6장) 숫자로 내보내면 0이 이미 사라진 상태입니다.
네이버 검색 API처럼 날짜를 20161208 같은 8자리 숫자 문자열로 주는 응답(블로그 검색 API의 postdate)도 조심해야 합니다. 이 도구는 이런 값을 String으로 둡니다. 직접 Date로 바꾸면 Mongoose는 숫자로만 된 큰 문자열을 밀리초로 읽기 때문에(Casting Edge Cases) 오류 없이 1970-01-01T05:36:01.208Z가 저장됩니다. 날짜로 다루려면 저장 전에 2016-12-08 형식으로 바꾸세요.
제한
- Mixed는 무엇이든 받습니다. 샘플 타입이 달라
Mixed가 된 필드는 타입 변환과 검증을 하지 않고, 내부를 바꾸면markModified()를 호출해야 Mongoose가 저장합니다. 데이터가 허용하면 한 타입으로 맞추세요. - Date로 인식하는 형식은 하나입니다.
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 문서의 멤버와 비교해 상태 표시줄에 두 그룹을 알려 줍니다. 첫 번째 그룹은 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 문서에서 두 그룹을 다시 만들어 확인합니다. 키 이름을 바꾸세요. - 경로가 되지 않는 키 이름이 세 개 있습니다. 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는 직접 추가하세요. - 타입 인수는 루트 스키마에만 붙습니다. 서브스키마의
new Schema()에는 타입 인수가 없고, 필수 필드를 꺼도 인터페이스 필드에?가 붙지 않습니다. Mongoose는 인터페이스와 스키마가 맞는지 확인하지 않으므로 선택 필드에는 직접?를 붙이세요.
FAQ
이 도구는 무엇을 생성하나요?
JSON에서 Mongoose 스키마 정의를 생성합니다. 중첩 객체는 서브스키마가 되어 그것을 쓰는 스키마보다 먼저 나오며(같은 키에서 필드와 타입이 같은 객체는 하나를 함께 씀), 맨 아래에 model export 구문이 붙습니다.
어떤 언어 모드를 지원하나요?
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·모델 이름·옵션이 같으면 다시 기록하지 않습니다.