このメソッドは、404(「見つかりません」)レスポンスを、res.json()またはres.view()を使用して送信するために使用されます。Sailsが明示的なルートまたはルートブループリントと一致しないリクエストを受信した場合(つまり、404ページを提供する場合)、自動的に呼び出されます。
アプリケーションコードから手動で呼び出された場合、このメソッドは通常、ユーザーエージェントが存在しないものを検索、更新、または削除しようとしたことを示すために使用されます。
return res.notFound();
他の組み込みのカスタムレスポンスモジュールと同様に、このメソッドの動作はカスタマイズ可能です。
デフォルトでは、次のように動作します。
"Not Found"
を含むレスポンスボディを送信します。views/404.ejs
にあるビューを提供しようとします(デフォルトのEJS ビューエンジンを想定)。そのようなビューが見つからない場合、またはビューを提供しようとしてエラーが発生した場合、文字列"Not Found"
を含むデフォルトのレスポンスボディが送信されます。Pet.findOne()
.where({ name: 'fido' })
.exec(function(err, fido) {
if (err) return res.serverError(err);
if (!fido) return res.notFound();
// ...
})
- このメソッドはターミナルです。つまり、これは一般的に、特定のリクエストに対してアプリケーションが実行する最後のコード行です(したがって、これらのドキュメント全体で
return
の使用が推奨されています)。res.notFound()
(他のユーザーランドレスポンスメソッドと同様に)はオーバーライドまたは変更できます。これは、api/responses/notFound.js
で定義されたレスポンスメソッドを実行します。アプリケーションにnotFound.js
レスポンスメソッドが存在しない場合、Sailsはデフォルトの動作を使用します。