View our GitHub

Please visit sails-docs on GitHub to view documentation on your mobile device.

Edit Page

.watch(request)

Purpose

This subscribes a client to publishCreate events for the model. Any connections that are "watching" the model class will be automatically subscribed to new model instances that are created using the blueprint create method.

Description Accepted Data Types Required ?
1 Request request object Yes

Note: watch will only work when the request is made over a socket connection (e.g. using socket.get), not over an http connection (e.g. using jquery.get).

Blueprints and .watch()

By default, the blueprint find and findOne actions will call .watch() on the model class. This behavior can be changed for all models by setting the sails.config.blueprints.autoWatch to false, or for a specific model by setting autoWatch to false in the model's class file.

Is something missing?

If you notice something we've missed or could be improved on, please follow this link and submit a pull request to the sails-docs repo. Once we merge it, the changes will be reflected on the website the next time it is deployed.

Reference

We wrote a book!

Get early access to the book
with promotion code: mcneildoc

Get the Book