編輯頁面
.removeFromCollection()
從指定的集合中移除一個或多個成員 (例如：評論)，(例如：BlogPost #4 的 comments)。
await Something.removeFromCollection(parentId, association)
.members(childIds);
用法
| 參數 | 類型 | 詳細資訊 | |
|---|---|---|---|
| 1 | parentId | 父記錄的主鍵值 (即 ids)。 必須為數字或字串 (例如： '507f191e810c19729de860ea' 或 49)。或者，可以指定數字或字串陣列 (例如： ['507f191e810c19729de860ea', '14832ace0c179de897'] 或 [49, 32, 37])。在這種情況下，所有 子記錄將從每個父記錄的相應集合中移除。 |
|
| 2 | association | 複數 ("集合") 關聯的名稱 (例如："pets") | |
| 3 | childIds | 要移除的子記錄的主鍵值 (即 ids)。請注意，這不會銷毀這些記錄，它只是將它們從指定的父項中分離。 |
錯誤
| 名稱 | 類型 | 何時？ |
|---|---|---|
| UsageError | 當傳入無效的內容時拋出。 | |
| AdapterError | 當資料庫配接器發生錯誤時拋出。 | |
| Error | 當發生任何其他非預期的情況時拋出。 |
請參閱 概念 > 模型與 ORM > 錯誤 以取得在 Sails 和 Waterline 中處理錯誤的範例。
範例
對於使用者 3，從 "pets" 集合中移除寵物 99 和 98
await User.removeFromCollection(3, 'pets')
.members([99,98]);
邊緣情況
- 如果父項 id (或任何一個父項 id，如果指定為陣列) 實際上與現有的、持久化的記錄不符，則這將修改現有的記錄並忽略不存在的記錄。
- 如果其中一個子項 id 實際上與現有的、持久化的記錄不符，則該子項 id 將被忽略，並且只有與其他提供的子項 id 對應的成員才會從集合中移除。
- 如果父記錄的集合沒有其中一個或多個子項 id 作為成員，則這些非成員的 id 將被忽略。
- 如果提供了空的子項 id 陣列，則這是一個 空操作。
- 如果提供了空的父項 id 陣列，則這是一個 空操作。
注意事項
- 此方法可以與
await、promise 鏈式調用或 傳統 Node 回呼 一起使用。- 如果關聯是 "雙向" 的 (表示它具有
via)，則子記錄將相應地被修改。如果另一側 (例如 "Pet") 的屬性是單數，則每個子記錄的外鍵 ("owner") 將被設定為null。如果是複數，則每個子記錄的集合將相應地被修改。
為了在 sailsjs.com 上獲得更好的體驗，更新您的瀏覽器。
參考
- 應用程式
- Blueprint 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
-
Request (`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
- Response (`res`)
- Waterline (ORM)
- WebSockets
參考
以愛打造
Sails 框架是由位於德州奧斯汀的 網路與行動商店，以及我們的貢獻者共同建立。我們在 2012 年創建 Sails，以協助我們進行 Node.js 專案。自然地，我們將其開源。我們希望它可以讓您的生活更輕鬆一點！
© 2012-2024 The Sails Company.
Sails 框架是基於 MIT 授權條款的自由開源軟體。
插圖由 Edamame 提供。