Explaining how to uncheck a pre-checked checkbox

[ThomasLandauer]

Sounds like a tongue twister ... ;-)

I was expecting this text to be in https://github.com/Codeception/lib-innerbrowser/blob/master/src/Codeception/Lib/InnerBrowser.php#L941 - while in fact it's even in another module! So, again, a link at each function to get to its source code would really be nice - see #6063 (comment)
(More precisely: If the documentation isn't where the function is, then two links)

[Naktibalda]

Isn't this just repeating that uncheckOption actually unchecks checkbox?

Is it a naming problem? Would it be better to rename uncheckOption to uncheckCheckbox?

[ThomasLandauer]

Well, let's look at this from the very beginning: Codeception has two ways to submit a form (right?):

• The "human" way: fillField, selectOption, etc., then click the submit button
• The "machine" way: submitForm and pass all values you want

The problem is that this unchecking scenario is the only (?) one where you need to mix those two ways.

So the (to me) perfect solution would be: Change submitForm so that it just submits what you pass in the array. I.e. do not submit "2" for the "plan" field in the example at https://codeception.com/docs/modules/Symfony#submitForm
Cause when I want to use what's on the page, I can just click. And if I want to test "fake/spam/whatever" submissions, I don't care what's on the page (even worse: If I don't fully understand this concept, some pre-set values might compromise my tests, in that they submit stuff I didn't think about).

Well, but changing submitForm would be a BC break...

And, yes, renaming uncheckOption to uncheckCheckbox is a good idea in any case! "Option" is an ambiguous term - e.g. selectOption refers to <select> and radio: https://codeception.com/docs/modules/Symfony#selectOption But checkbox is checkbox is checkbox :-)