View our GitHub

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

Edit Page

sails.log()

Overview

Each of the methods below accepts an infinite number of arguments of any data type, seperated by commas. Like console.log, data passed as arguments to the Sails logger is automatically prettified for readability using Node's util.inspect(). Consequently, standard Node.js conventions apply- i.e. if you log an object with an inspect() method, it will be run automatically, and the string that it returns will be written to the console. Similarly, objects, dates, arrays, and most other data types are pretty-printed using the built-in logic in util.inspect() (e.g. you see { pet: { name: 'Hamlet' } } instead of [object Object].)

sails.log()

The default log function, which writes console output to stderr at the "debug" log level.

sails.log('hello');
// -> debug: hello.

sails.log.error()

Writes log output to stderr at the "error" log level.

sails.log.error('Unexpected error occurred.');
// -> error: Unexpected error occurred.

sails.log.warn()

Writes log output to stderr at the "warn" log level.

sails.log.warn('File upload quota exceeded for user','request aborted.');
// -> warn: File upload quota exceeded for user- request aborted.

sails.log.debug()

Alias for sails.log()

sails.log.info()

Writes log output to stdout at the "info" log level.

sails.log.info('A new user (', '[email protected]', ') just signed up!');
// -> info: A new user ( [email protected] ) just signed up!

sails.log.verbose()

Writes log output to stdout at the "verbose" log level. Useful for capturing detailed information about your app that you might only want to enable on rare occasions.

sails.log.verbose('A user initiated an account transfer...')
// -> verbose: A user initiated an account transfer...

sails.log.silly()

Writes log output to stdout at the "silly" log level. Useful for capturing utterly ridiculous information about your app you only need on rare occasions.

sails.log.silly('A user probably clicked on something..?');
// -> silly: A user probably clicked on something..?

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.