ページの編集
.removeFromCollection()
指定されたコレクション（例：BlogPost #4のcomments）から、1つまたは複数のメンバー（例：コメント）を削除します。
await Something.removeFromCollection(parentId, association)
.members(childIds);
使用法
| 引数 | 型 | 詳細 | |
|---|---|---|---|
| 1 | parentId | 親レコードの主キー値（つまりID）。 数値または文字列である必要があります（例： '507f191e810c19729de860ea'または49）。あるいは、数値または文字列の配列を指定することもできます（例： ['507f191e810c19729de860ea', '14832ace0c179de897']または[49, 32, 37]）。この場合、すべての子レコードが、各親レコードの適切なコレクションから削除されます。 |
|
| 2 | association | 複数形の（「コレクション」）関連の名前（例：「pets」）。 | |
| 3 | childIds | 削除する子レコードの主キー値（つまりID）。これはこれらのレコードを破棄するのではなく、指定された親からそれらを切り離すだけであることに注意してください。 |
エラー
| 名前 | 型 | いつ？ |
|---|---|---|
| UsageError | 無効なものが渡された場合にスローされます。 | |
| AdapterError | データベースアダプターで問題が発生した場合にスローされます。 | |
| Error | 予期しない何かが発生した場合にスローされます。 |
SailsおよびWaterlineでのエラー処理の例については、コンセプト > モデルとORM > エラーを参照してください。
例
ユーザー3について、「pets」コレクションからペット99と98を削除します。
await User.removeFromCollection(3, 'pets')
.members([99,98]);
エッジケース
- 親ID（または配列として指定された場合、親IDのいずれか）が実際には既存の永続化されたレコードに対応しない場合、これは既存のレコードを変更し、存在しないレコードを無視します。
- 子IDの1つが実際には既存の永続化されたレコードに対応しない場合、その子IDは無視され、提供された他の子IDに対応するメンバーのみがコレクションから削除されます。
- 親レコードのコレクションが、これらの子IDの1つ以上をメンバーとして持っていない場合、それらの非メンバーのIDは無視されます。
- 子IDの空の配列が提供された場合、これは無操作です。
- 親IDの空の配列が提供された場合、これは無操作です。
注
- このメソッドは、
await、Promiseチェーン、または従来のNodeコールバックで使用できます。- 関連が「双方向」（つまり
viaを持っている）の場合、子レコードはそれに応じて変更されます。反対側（例：「Pet」）の属性が単数の場合、各子レコードの外部キー（「owner」）はnullに設定されます。それが複数の場合、各子レコードのコレクションはそれに応じて変更されます。
sailsjs.comでのより良いエクスペリエンスのために、ブラウザを更新してください。
リファレンス
- アプリケーション
- ブループリントAPI
- コマンドラインインターフェース
-
設定
- sails.config.*
- sails.config.blueprints
- sails.config.bootstrap()
- sails.config.custom
- sails.config.datastores
- sails.config.globals
- sails.config.http
- sails.config.i18n
- sails.config.log
- sails.config.models
- sails.config.policies
- sails.config.routes
- sails.config.security
- sails.config.session
- sails.config.sockets
- sails.config.views
-
リクエスト (`req`)
- req._startTime
- req.body
- req.cookies
- req.fresh
- req.headers
- req.hostname
- req.ip
- req.ips
- req.isSocket
- req.method
- req.options
- req.originalUrl
- req.params
- req.path
- req.protocol
- req.query
- req.secure
- req.signedCookies
- req.socket
- req.subdomains
- req.url
- req.wantsJSON
- req.xhr
- req.accepts()
- req.acceptsCharsets()
- req.acceptsLanguages()
- req.allParams()
- req.file()
- req.get()
- req.is()
- req.param()
- req.setLocale()
- req.setTimeout()
- req.host
- レスポンス (`res`)
- Waterline (ORM)
- WebSockets
リファレンス
愛を込めて構築されました
Sails フレームワークは、オースティン、テキサス州にあるウェブ＆モバイルショップが、貢献者の助けを借りて構築しています。2012年に Node.js プロジェクトを支援するために Sails を作成しました。当然のことながら、オープンソース化しました。皆様の生活が少しでも楽になることを願っています！
© 2012-2024 The Sails Company.
Sails フレームワークは、MIT ライセンスの下で無料でオープンソースです。
イラスト：Edamame.