0.16.3 • Published 9 years ago

try-defer v0.16.3

Weekly downloads
231
License
MIT
Repository
github
Last release
9 years ago

try-defer

Composes a function that will try logic and accumulate failures to be retried at a deferred time.

npm i -S try-defer

NPM

Why?

I built this library to solve the many issues surrounding server-side rendering of css (specifically within library projects for my use case). With this project, I can attempt to run a bunch of unknown code, and if it fails, serialize the failures to a string to be executed on the browser.

Usage

import tryDefer from 'try-defer'

const [ inBrowser, defer ] = tryDefer(() => typeof window === 'object')

const alert = inBrowser((...args) => window.alert(`ONLY RUN ON BROWSER => ${JSON.stringify(args)}`))
const setBG = inBrowser((color) => document.body.style.backgroundColor = color)

/** This may or may not work. If it is bypassed or causes an error, it will be accumulated in the replay event to be executed at a deferred time.
alert(1, 2, 3)
setBG('yellow')
alert('deffferrrrr')
alert('this is in browser')
setBG('blue')

// ...

/**
 * replay
 * reruns all of the failed calls in order.
 * any failures will be repeated again on future replays.
 */
defer.replay()

OR - if you want to have the replay embedded into the server rendered page and run on the client:

/**
 * serialize
 * serializes the replay event into a script tag that will be run when the client loads.
 */
const html = `<!doctype html>
<html>
  <head>
    ${defer.serialize()}
  </head>
  <body>
    ${content}
  </body>
</html>

OR - if you are in a React project attempting server rendering:

import React from 'react'
import { renderToString } from 'react-dom/server'
import { createMemoryHistory, match, RouterContext } from 'react-router'
import { Provider } from 'react-redux'
import { syncHistoryWithStore } from 'react-router-redux'

//....

router.use((req, res, next) => {
  let memoryHistory = createMemoryHistory(req.path)
  let store = configureStore(memoryHistory)
  let history = syncHistoryWithStore(memoryHistory, store)

  /* react router match history */
  match({ history, routes, location: req.url }, (error, redirectLocation, renderProps) => {
    const content = renderToString(<Provider store={store}><RouterContext {...renderProps} /></Provider>)

    /** Returns a component that reruns the logic in a browser environment. */
    const Replay = defer.reactReplay(React)

    const html = `<!doctype html>
    ${renderToString((
      <html>
        <head>
          <Replay />
        </head>
        <body>
          {content}
        </body>
      </html>
    )}`

    res.send(html)
  })

})
0.16.3

9 years ago

0.16.1

9 years ago

0.15.0

10 years ago

0.13.1

10 years ago

0.14.1

10 years ago

0.14.0

10 years ago

0.12.1

10 years ago

0.12.0

10 years ago

0.11.6

10 years ago

0.11.5

10 years ago

0.11.4

10 years ago

0.11.3

10 years ago

0.11.2

10 years ago

0.11.1

10 years ago

0.11.0

10 years ago

0.10.1

10 years ago

0.10.0

10 years ago

0.9.3

10 years ago

0.9.2

10 years ago

0.9.1

10 years ago

0.8.2

10 years ago

0.8.1

10 years ago

0.8.0

10 years ago

0.7.3

10 years ago