Meiosis Documentation

Table of Contents

Using the Meiosis Tracer

The Meiosis Tracer is a tool to observe, rewind, and replay streams and see the results in the view. It's quite useful when developing and debugging an application.

Let's add the tracer to our previous example.

Tracing Streams

To use the tracer, we'll need to import meiosisTracer and call it with some parameters to set up communication between the streams and the UI that displays stream values. The UI allows us to rewind, replay, and even type in stream values directly, and see the resulting view.

You can see the tracer below:

To use the Meiosis Tracer, we have two options:

  1. Add a DOM element to our page to hook up the UI, or
  2. Use the Chrome extension in which case we do not need to change our page. The extension displays the Tracer in Chrome's DevTools.

Using Meiosis Tracer

Let's start with the first option. In the HTML, we've added a <div> where the tracer will be displayed:

<div id="tracer"></div>

Notice that we've given it an id of tracer. Finally, we initialize the Tracer by passing it the selector to our <div>, and the streams that we want to trace:

meiosisTracer({ selector: "#tracer", streams: [ models ] });

That will display the Tracer on our page.

Using the Chrome Extension

The second option to use the Tracer is to install the Chrome extension. In that scenario, we do not pass the selector parameter, and we don't need to add a DOM element to our application. We just pass the streams that we want to trace:

meiosisTracer({ streams: [ models ] });

When you open Chrome's DevTools, you'll see a Meiosis tab containing the Tracer UI.

Rewind, Replay, Observe

Try entering values in the text fields of the example, increasing and decreasing the temperature, and then click on the Save button. As you are doing this, you'll see snapshots of the model being displayed in the tracer. You'll also notice an increase in the total number on the slider.

Next, try dragging the slider back towards the left, and then towards the right. You'll see that you are rewinding and replaying the model snapshots, with the view showing the corresponding results.

Finally, try typing in values directly in the model textarea, and pressing the Send button. As long as you have valid JSON, you should see the view reflect the result of rendering with the model that you've entered.

This is a great way to develop and debug an application. You can see what the view looks like for a given model. If you enter a temperature value, you'll see it in the view. If you change the temperature units from C to F, you see in fact that the view does not reflect the change. You've discovered that we are not (yet) using the units from the model! We'll be fixing that in the next part.

Principles / Takeaways

Up Next

Let's take a step back and summarize what we've learned by looking at the Meiosis Goals.

Table of Contents

Meiosis is developed by @foxdonut00 / foxdonut and is released under the MIT license.