docs/tape.html

<!DOCTYPE HTML>
<html lang="en" >
    
    <head>
        
        <meta charset="UTF-8">
        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
        <title>tape | Redux Actions Assertions</title>
        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
        <meta name="description" content="">
        <meta name="generator" content="GitBook 2.6.7">
        
        
        <meta name="HandheldFriendly" content="true"/>
        <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
        <meta name="apple-mobile-web-app-capable" content="yes">
        <meta name="apple-mobile-web-app-status-bar-style" content="black">
        <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
        <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
        
    <link rel="stylesheet" href="gitbook/style.css">
    
        
        <link rel="stylesheet" href="gitbook/plugins/gitbook-plugin-highlight/website.css">
        
    
        <link rel="stylesheet" href="gitbook/plugins/gitbook-plugin-search/search.css">
        
    
        <link rel="stylesheet" href="gitbook/plugins/gitbook-plugin-fontsettings/website.css">
        
    
    <link rel="prev" href="./should.html" />
    

    </head>
    <body>
        
        
    <div class="book"
        data-level="3.7"
        data-chapter-title="tape"
        data-filepath="tape.md"
        data-basepath="."
        data-revision="Wed Jan 18 2017 12:57:27 GMT+0100 (CET)"
        data-innerlanguage="">
    

<div class="book-summary">
    <nav role="navigation">
        <ul class="summary">
            
            
        <li class="chapter " data-level="0" data-path="index.html">
            
                
                    <a href="./index.html">
                
                        <i class="fa fa-check"></i>
                        
                        Introduction
                    </a>
            
            
        </li>
    
        <li class="chapter " data-level="1" data-path="what_it_does.html">
            
                
                    <a href="./what_it_does.html">
                
                        <i class="fa fa-check"></i>
                        
                            <b>1.</b>
                        
                        What it does
                    </a>
            
            
        </li>
    
        <li class="chapter " data-level="2" data-path="installation.html">
            
                
                    <a href="./installation.html">
                
                        <i class="fa fa-check"></i>
                        
                            <b>2.</b>
                        
                        Installation
                    </a>
            
            
        </li>
    
        <li class="chapter " data-level="3" data-path="javascript.html">
            
                
                    <a href="./javascript.html">
                
                        <i class="fa fa-check"></i>
                        
                            <b>3.</b>
                        
                        API Reference
                    </a>
            
            
            <ul class="articles">
                
    
        <li class="chapter " data-level="3.1" data-path="chai.html">
            
                
                    <a href="./chai.html">
                
                        <i class="fa fa-check"></i>
                        
                            <b>3.1.</b>
                        
                        chai
                    </a>
            
            
        </li>
    
        <li class="chapter " data-level="3.2" data-path="expect.html">
            
                
                    <a href="./expect.html">
                
                        <i class="fa fa-check"></i>
                        
                            <b>3.2.</b>
                        
                        expect
                    </a>
            
            
        </li>
    
        <li class="chapter " data-level="3.3" data-path="expectjs.html">
            
                
                    <a href="./expectjs.html">
                
                        <i class="fa fa-check"></i>
                        
                            <b>3.3.</b>
                        
                        expect.js
                    </a>
            
            
        </li>
    
        <li class="chapter " data-level="3.4" data-path="jasmine.html">
            
                
                    <a href="./jasmine.html">
                
                        <i class="fa fa-check"></i>
                        
                            <b>3.4.</b>
                        
                        jasmine
                    </a>
            
            
        </li>
    
        <li class="chapter " data-level="3.5" data-path="jest.html">
            
                
                    <a href="./jest.html">
                
                        <i class="fa fa-check"></i>
                        
                            <b>3.5.</b>
                        
                        jest
                    </a>
            
            
        </li>
    
        <li class="chapter " data-level="3.6" data-path="should.html">
            
                
                    <a href="./should.html">
                
                        <i class="fa fa-check"></i>
                        
                            <b>3.6.</b>
                        
                        should
                    </a>
            
            
        </li>
    
        <li class="chapter active" data-level="3.7" data-path="tape.html">
            
                
                    <a href="./tape.html">
                
                        <i class="fa fa-check"></i>
                        
                            <b>3.7.</b>
                        
                        tape
                    </a>
            
            
        </li>
    

            </ul>
            
        </li>
    

            <li class="divider"></li>
            <li>
                <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
                    Published with GitBook
                </a>
            </li>
            
        </ul>
    </nav>
</div>

    <div class="book-body">
        <div class="body-inner">
            <div class="book-header" role="navigation">
    <!-- Actions Left -->
    

    <!-- Title -->
    <h1>
        <i class="fa fa-circle-o-notch fa-spin"></i>
        <a href="./" >Redux Actions Assertions</a>
    </h1>
</div>

            <div class="page-wrapper" tabindex="-1" role="main">
                <div class="page-inner">
                
                
                    <section class="normal" id="section-">
                    
                        <h1 id="tape"><a href="https://github.com/substack/tape" target="_blank">tape</a></h1>
<h2 id="usage">Usage</h2>
<pre><code class="lang-js"><span class="hljs-comment">// using ES6 modules</span>
<span class="hljs-keyword">import</span> test <span class="hljs-keyword">from</span> <span class="hljs-string">&apos;tape&apos;</span>;
<span class="hljs-keyword">import</span> { assertions } <span class="hljs-keyword">from</span> <span class="hljs-string">&apos;redux-actions-assertions&apos;</span>;

<span class="hljs-comment">// using CommonJS modules</span>
<span class="hljs-keyword">var</span> test = <span class="hljs-built_in">require</span>(<span class="hljs-string">&apos;tape&apos;</span>);
<span class="hljs-keyword">var</span> assertions = <span class="hljs-built_in">require</span>(<span class="hljs-string">&apos;redux-actions-assertions&apos;</span>).assertions;
</code></pre>
<p>Usage is the same as the <a href="https://redux-things.github.io/redux-actions-assertions/javascript.html" target="_blank">plain JavaScript assertions</a>, you just need to set up the correct <code>pass</code> and <code>fail</code> callbacks. Also, be sure to call <code>end</code> in a <code>Promise.then</code>, or <code>plan</code> with the number of assertions you&apos;re making in the test (see below).</p>
<h3 id="todispatchactions">toDispatchActions</h3>
<blockquote>
<p><code>toDispatchActions(action, expectedActions, done, fail)</code></p>
</blockquote>
<p>Asserts that when given <code>action</code> is dispatched it will dispatch <code>expectedActions</code>. <code>action</code> can be plain object (action) or function (action creator). <code>expectedActions</code> can be can be plain object (action) or function (action creator) or array of objects/functions.</p>
<pre><code class="lang-js"><span class="hljs-comment">// Using `t.plan`</span>
test(<span class="hljs-string">&apos;Thunk: editTag&apos;</span>, (t) =&gt; {
  t.plan(<span class="hljs-number">1</span>)
  toDispatchActions(testActionCreator(), [{ type: <span class="hljs-string">&apos;MY_ACTION_START&apos;</span> }], t.pass, t.fail);
});

<span class="hljs-comment">// Using `t.end`</span>
test(<span class="hljs-string">&apos;Thunk: editTag&apos;</span>, (t) =&gt; {
  toDispatchActions(testActionCreator(), [{ type: <span class="hljs-string">&apos;MY_ACTION_START&apos;</span> }], t.pass, t.fail)
    .then(t.end);
});
</code></pre>
<h3 id="tonotdispatchactions">toNotDispatchActions</h3>
<blockquote>
<p><code>toNotDispatchActions(action, expectedActions, done, fail)</code></p>
</blockquote>
<p>Asserts that when given <code>action</code> is dispatched it will not dispatch <code>expectedActions</code>. <code>action</code> can be plain object (action) or function (action creator). <code>expectedActions</code> can be can be plain object (action) or function (action creator) or array of objects/functions.</p>
<pre><code class="lang-js">test(<span class="hljs-string">&apos;Thunk: editTag&apos;</span>, (t) =&gt; {
  t.plan(<span class="hljs-number">1</span>);
  toNotDispatchActions(testActionCreator(), [{ type: <span class="hljs-string">&apos;MY_ACTION_START&apos;</span> }], t.pass, t.fail);
});
</code></pre>
<h3 id="todispatchactionswithstate">toDispatchActionsWithState</h3>
<blockquote>
<p><code>toDispatchActionsWithState(initialState, action, expectedActions, done, fail)</code></p>
</blockquote>
<p>Same as <code>toDispatchActions</code> + asserts that store initialised with <code>state</code> before <code>action</code> is dispatched.</p>
<pre><code class="lang-js">test(<span class="hljs-string">&apos;Thunk: editTag&apos;</span>, (t) =&gt; {
  t.plan(<span class="hljs-number">1</span>);
  toDispatchActions({property: <span class="hljs-string">&apos;value&apos;</span>}, testActionCreator(), [{ type: <span class="hljs-string">&apos;MY_ACTION_START&apos;</span> }], t.pass, t.fail);
});
</code></pre>
<h3 id="tonotdispatchactionswithstate">toNotDispatchActionsWithState</h3>
<blockquote>
<p><code>toNotDispatchActionsWithState(initialState, action, expectedActions, done, fail)</code></p>
</blockquote>
<p>Same as <code>toNotDispatchActions</code> + asserts that store initialised with <code>state</code> before <code>action</code> is dispatched.</p>
<pre><code class="lang-js">test(<span class="hljs-string">&apos;Thunk: editTag&apos;</span>, (t) =&gt; {
  t.plan(<span class="hljs-number">1</span>);
  toNotDispatchActions({property: <span class="hljs-string">&apos;value&apos;</span>}, testActionCreator(), [{ type: <span class="hljs-string">&apos;MY_ACTION_START&apos;</span> }], t.pass, t.fail);
});
</code></pre>

                    
                    </section>
                
                
                </div>
            </div>
        </div>

        
        <a href="./should.html" class="navigation navigation-prev navigation-unique" aria-label="Previous page: should"><i class="fa fa-angle-left"></i></a>
        
        
    </div>
</div>

        
<script src="gitbook/app.js"></script>

    
    <script src="gitbook/plugins/gitbook-plugin-ga/plugin.js"></script>
    

    <script src="gitbook/plugins/gitbook-plugin-search/lunr.min.js"></script>
    

    <script src="gitbook/plugins/gitbook-plugin-search/search.js"></script>
    

    <script src="gitbook/plugins/gitbook-plugin-sharing/buttons.js"></script>
    

    <script src="gitbook/plugins/gitbook-plugin-fontsettings/buttons.js"></script>
    

<script>
require(["gitbook"], function(gitbook) {
    var config = {"ga":{"token":"UA-78823490-1","configuration":"auto"},"highlight":{},"search":{"maxIndexSize":1000000},"sharing":{"facebook":false,"twitter":false,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"],"website":false},"fontsettings":{"theme":"white","family":"sans","size":2}};
    gitbook.start(config);
});
</script>

        
    </body>
    
</html>