[TwigComponent] Blocks set with TestHelper don't get evaluated

[janopae]

When playing with the reproducer I created for #3210, I realised InteractsWithTwigComponents::renderTwigComponent did not at all behave the way I expected:

Twig code inside blocks set using the $blocks parameter won't be evaluated. Variables won't be resolved, and Twig functions won't be executed. Instead, the resulting HTML will contain placeholders like {{ message }}.

This means that at the current state of the helper, basic interactions of components with their blocks can't be tested: You can't test if variables are being passed correctly or if their content is right.

This is a feature request to allow some form of testing the variables Twig components pass to their blocks.

#3211 would be a way to implement this, as it would enable evaluation of the blocks.

[smnandre]

I'm thinking you're reading this in the wrong side.

InteractWithTwigComponent is not made to test what context your component passes to Twig... but in the contrary to test what HTML is rendered depending on the context and what data is passed. ... and was mostly documented for embeds only, as passing blocks to TwigComponent is very similar to the behaviour of embed blocks.

Passing determinist/dependency-free content (instead of runtime resolved blocks) can help tests performances while increasing their value.

basic interactions of components with their blocks can't be tested

Not sure what you mean here, how would you do in Twig?

[janopae]

Imagine a list component:

<ul>
  {% for item in items %}
    <li>{% block content %}{# Variable `item` shall be available in the block and contain the current item #}{% endblock %}</li>
  {% endfor %}
</ul>

It will be used like this:

<twig:App:List items="{{ items }}">
  <h4>{{ item.title }}</h4>
  <p>{{ item.text }}</p>
</twig:App:List>

How would you test that the variable {{ item }} is available in the block and contains the right content?

Given the structure of the component, that would be the main thing to test IMHO, because it's a significant part of the contract between the component and its users.

[smnandre]

Imagine a list component:

 {% for item in items %}
   <li>{% block content %}{# Variable `item` shall be available in the block and contain the current item #}{% endblock %}</> li>
 {% endfor %}
</ul>

> (...) 
>How would you test that the variable {{ item }} is available in the block and contains the right content?

You should not test the framework, but your code. 

But if you want to ... make a functional test ? 

Two templates, one render, and test the end result? 

[janopae]

You should not test the framework, but your code.

So how do I test that my code sets those vairables correctly? Without my code, no framework will set an item variable. And especially will it not set the far more complicated variables real-life templates will set (rather than my simplified example)¹.

I test my code to ensure the interfaces my code provides work and are stable. In this case, the interface my template code creates by declaring that block. Ideally without including more of the framework I need, and ideally with as little artificial code as possible only written for testing purposes.

Footnotes

1. One component I currently want to test groups a list of date intervals by day, it has a block for each day, and the block will get passed the following vars: a list of intervals for that day, the date, and a boolean whether its the last day in the list ↩