Skip to content
/ supersniff Public

A simple function for debugging stuff like promise chains and other pipeline-like thingees. It just creates a function that console logs whatever is passed to it and then returns that value.

License

Notifications You must be signed in to change notification settings

mpj/supersniff

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

supersniff

A simple function for debugging stuff like promise chains, streams and other pipeline-like thingees. It just creates a function that console logs whatever is passed to it and then returns that value

Example:

const sniff = require('supersniff')

fetch(`http://myapi.com/users/${username}.json`))
  .then(response => response.json())
  .then(sniff) // Will console.log out the parsed json, and return the value,
               // effectively passing it on to the next .then
  .then(user => Promise.all(user.friends.map(friend => getFriend(friendId))))
  .then(friends => /* do even more stuff here */)

Why this is useful?

Lets say that you have a promise chain that looks like this ...

getData()
  .then(transformData)
  .then(sortData)

... and you are debugging an issue that makes you want to inspect what the data looks like after the transformData operation, but BEFORE the sortData operation. No matter if you want to do this by breakpoint or console.log, you need to wrap transformData in a multiline functions:

getData()
  .then(x => {
    console.log(x) // alternatively, breakpoint on the line below
    return transformData(x)
  })
  .then(sortData)

It's not a huge hassle, but I found myself doing it a LOT, and with supersniff there is a lot less typing:

getData()
  .then(transformData)
  .then(sniff)
  .then(sortData)

Yes, this is stupidly simple, but I've found myself writing this function 40000 times now so I want it on npm, OK? OK!?????

Overrriding prefix

supersnitt will log to console with a [SNIFF] prefix but if you want to override it like this:

const sniff = require('supersniff')

fetch(`http://myapi.com/users/${username}.json`)
  .then(response => response.json())
  .then(sniff.tag('MYTAG'))

Sniffing to file

const sniff = require('supersniff')

fetch(`http://myapi.com/users/${username}.json`)
  .then(response => response.json())
  .then(sniff.save('apioutput.json'))

Loading file contents conviniently

const sniff = require('supersniff')
/*
fetch(`http://slowexpensivethrottledapi.com/users/${username}.json`)
  .then(response => response.json())
  .then(sniff.save('apioutput.json'))*/

sniff.load('apioutput.json')
  .then(data => data.friends[0].fullName)
  .then(sniff)

Memoizing expensive calls to file

const sniff = require('supersniff')
sniff.memo('apioutput.json', () =>
  fetch(`http://slowexpensivethrottledapi.com/users/${username}.json`)
    .then(response => response.json()))
.then(data => data.friends[0].fullName)
.then(sniff)

About

A simple function for debugging stuff like promise chains and other pipeline-like thingees. It just creates a function that console logs whatever is passed to it and then returns that value.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published