Hoot Documentation Coming Soon? Or is QUnit still usable?

[AbdelrahmanSadat]

I recently started working on a custom module for Odoo 18.0. And while attempting to create unit tests for my Javascript files by following the testing guide, I realized that the documentation is out of date and doesn't match at all the test runner served on /web/test.

Basically I noticed that the documentatin still describes QUnit, while this version of Odoo (18.0) uses the new Hoot framework.
The only mention of the Hoot framework I found was from this talk.

So when would documentation for Hoot be coming for Odoo's docs, and is QUnit still usable on 18.0?

[jum-odoo]

Hi @AbdelrahmanSadat, the documentation is indeed out of date for JavaScript unit tests, as QUnit is now being deprecated as we convert unit tests to Hoot (QUnit is expected to be gone in the next major version, or soon after). So, to answer your last question: yes, it is still possible to write QUnit tests in 18.0, but we expect it to be the last version where QUnit is included in our code base, so you should probably write Hoot tests instead.

New pages of documentation are being written, but as we work with limited resources, we have to prioritize other more important tasks (like the conversion of remaining tests) to ensure the testing framework stability and reliability.

Note that while there isn't a centralized documentation yet, there are already plenty of examples of various test cases in the Odoo code base, and each export from Hoot and test helpers should include some precise inline docstring, sometimes with examples.

[kesowkk]

@jum-odoo
Hi @jum-odoo, I understand that documentation for JavaScript unit tests is currently being prioritized for Hoot. If there's a need for documentation related to accounting and financial aspects, I'm available to assist. Let me know how I can contribute!