View and Compilation Spies
If you've installed the aurelia-testing plugin, you have access to two special custom attributes for debugging templates: view-spy and compile-spy.
Installation
npm install aurelia-testingRegister the plugin in your main.js or main.ts:
export function configure(aurelia) {
aurelia.use
.standardConfiguration()
.plugin('aurelia-testing'); // Enables view-spy and compile-spy
}view-spy
The view-spy attribute logs Aurelia's internal View object to the browser console when the element is bound. This gives you access to the view's binding context, overrideContext, and all associated bindings.
<template>
<p view-spy>Hello!</p>
</template>Open your browser's developer console, and you'll see the View object logged. You can inspect:
bindingContext— The view-model bound to the templateoverrideContext— Contextual properties like$parent,$index, etc.bindings— All active data bindings on the elementchildren— Any child views (e.g., from repeaters or compositions)
This is particularly useful when debugging data binding issues or verifying that the correct data is reaching your template.
compile-spy
The compile-spy attribute logs the compiler's TargetInstruction to the console during compilation. This reveals how Aurelia interpreted your template markup — what bindings, behaviors, and custom elements it detected.
The logged TargetInstruction includes:
expressions— Binding expressions found on the elementbehaviorInstructions— Custom attributes and behaviors appliedcontentExpression— Instructions for the element's text content
Using Both Together
You can apply both attributes to the same element for comprehensive debugging:
This logs both the compiled instructions (how Aurelia parsed the template) and the runtime view (the live binding state), giving you a complete picture of what's happening.
Debugging Repeaters
Spies are especially helpful when debugging repeat.for to inspect each iteration's binding context:
Each repeated item logs its own View object, letting you verify that $index, $first, $last, and other contextual properties are correct.
Last updated
Was this helpful?