From 3749ffb477aacdb16bfecab803414d5f22897724 Mon Sep 17 00:00:00 2001
From: Yoshua Wuyts <i@yoshuawuyts.com>
Date: Tue, 31 May 2016 15:54:46 +0200
Subject: [PATCH] start: throw err for render races

---
 README.md | 17 +++++++++++++++++
 index.js  |  1 +
 2 files changed, 18 insertions(+)

diff --git a/README.md b/README.md
index 59f366b..4a77b69 100644
--- a/README.md
+++ b/README.md
@@ -71,6 +71,7 @@
   - [Styles](#styles)
   - [Rendering in Node](#rendering-in-node)
 - [API](#api)
+- [Errors](#errors)
 - [FAQ](#faq)
 - [Installation](#installation)
 - [See Also](#see-also)
@@ -609,6 +610,22 @@ following values:
   href="<location>"></a>` clicks and update internal `state.location`
   accordingly.
 
+## Errors
+### Could not find DOM node (#id) to update
+This means that a re-render of the DOM was triggered before the first render
+was done. This is usually the case when `send()` is called inside a
+`subscription` before the DOM is done rendering. Instead try listening for a
+`'DOMContentLoaded'` event:
+```js
+document.addEventListener('DOMContentLoaded', (e) => send('init'))
+```
+
+### send() cannot be called on the server
+This means a `send()` event was triggered in Node. In Node, `reducers`,
+`effects` and `subscriptions` are disabled for performance reasons, so if
+`send()` was called to trigger an action it wouldn't work. Try finding where in
+the DOM tree `send()` is called, and disable it when called from within Node.
+
 ## FAQ
 ### Why did you build this?
 `choo` is nothing but a formalization of how I've been building my applications
diff --git a/index.js b/index.js
index a8f03a6..ff6b089 100644
--- a/index.js
+++ b/index.js
@@ -163,6 +163,7 @@ function choo () {
     function onchange (action, newState, oldState) {
       if (newState === oldState) return
       const oldTree = document.querySelector('#' + rootId)
+      assert.ok(oldTree, "Could not find DOM node '#" + rootId + "' to update")
       const newTree = _router(newState.app.location, newState, send, oldState)
       newTree.setAttribute('id', rootId)
       yo.update(oldTree, newTree)