I found this topic about testing plugins (automatically), but haven’t come across any mentioning how to test themes or theme components. Are there any examples of how to use QUnit (or similar) with themes?

You can add it to a user selectable theme or use the test link on the theme admin page.

Sorry, I meant automated testing – I will amend my previous post. I was thinking of something like QUnit that some plugins already use.

No, it’s not possible to add QUnit tests to themes/components at the moment… @david how possible would it be possible to add support for a /test folder like plugins? we’d also have to enable the theme when the tests are run because the core tests run without any theme, right?

Certainly possible, but will need some work. Right now all the theme javascript files are bundled together into one file. We would need to make sure tests are put in a new, separate bundle, so that they don’t get served to regular visitors. And then once that’s done, make a way to run qunit tests fo…

This is one of the major downsides of theme components in my opinion. They are super easy to deploy which is fantastic, but testing often gets put aside.

If I understand correctly, anything that can be done with a theme component can be done with a plugin. The former is easier to deploy, while the latter allows testing.

Yes that is generally accurate. It ends up being a trade off in terms of what you are customising. For example adding a custom stylesheet probably couldn’t be tested even in a plugin. Adding custom javascript controls and widgets is where things become questionable.

I feel like we should consider this issue when we do the ember cli work. There is nothing impossible about having some sort of test runner for themes, and we could ship some of the basics in the discourse-theme gem to set up local testing using ember cli.

[image] sam: we could ship some of the basics in the discourse-theme gem to set up local testing using ember cli Running theme tests would require a full installation of Discourse though, right? There are so many interdependencies I don’t think we could test themes independently :thinking: M…

[image] sam: Running theme tests would require a full installation of Discourse though, right? The whole idea with ember cli is that we are cleanly splitting server from client. We could ship enough of the JS side of things to test the client without running a rails server. You would still ne…

How to test themes or theme components?

Development

merefield (Robert) January 15, 2022, 12:48pm 16

I think goal would be to be able to run them in CI on GitHub as we currently can with specs (both Theme.and Plugin JS)?

Topic		Replies	Views
How to run Discourse core, plugin and theme QUnit test suites Developer Guides how-to , code	0	2918	July 26, 2017
Overriding plugin javascript in a theme component Development	11	1424	October 10, 2022
Acceptance test for a plugin feature which is been rendered in the custom theme component Development	0	499	January 29, 2019
End-to-end system testing for themes and theme components Developer Guides how-to , theme-guides	1	1349	January 2, 2025
Plugin stylesheets are not included in qunit tests Development	0	358	September 7, 2021

How to test themes or theme components?

Related topics