编辑页面
.removeFromCollection()
从指定集合中删除一个或多个成员（例如，评论）（例如，博客文章 #4 的 comments）。
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 之一实际上不对应于任何现有的持久记录，则该子 ID 将被忽略，并且只有与其他提供的子 ID 对应的成员将从集合中删除。
- 如果父记录的集合没有一个或多个这些子 ID 作为成员，则这些非成员的 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 年创建 Sails，以帮助我们进行 Node.js 项目。自然地，我们将其开源了。我们希望它能让您的生活变得更轻松！
© 2012-2024 The Sails Company.
Sails 框架是根据 MIT 许可免费开源的。
插图由 Edamame 提供。