ページ編集

`.toJSON()`

目的

Waterlineがレコードを取得するたびに、そのレコードのモデルにcustomToJSONメソッドが定義されているかどうかをチェックします。定義されている場合、WaterlineはそのメソッドをレコードのtoJSONプロパティとして追加します。toJSONはコード内で直接呼び出すことを意図していません。JSON.stringify()を呼び出してレコードをシリアライズする際に自動的に使用されます。特にres.json()メソッドはこの方法でオブジェクトを文字列化します。

モデルにcustomToJSONが定義されている場合、.find()、.findOne()、.findOrCreate()、.stream()によって取得されたレコード、および.create()、.createEach()、.update()、.destroy()への呼び出しでfetchメタキーをtrueに設定して取得されたレコードに、.toJSON()メソッドが追加されます。 .populate()を介して子レコードが添付されており、対応するモデルにcustomToJSONメソッドがある場合、子レコードにも.toJSON()関数が添付されます。