Changing a to SkipConvey() prevents the func() passed into that call from running. This also has the consequence of preventing any nested Convey registrations from running. The reporter will indicate that the registration was skipped.

Using SkipConvey() has nearly the same effect as commenting out the testentirely. However, this is preferred over commenting out tests to avoid theusual "declared/imported but not used" errors. Usage of SkipConvey() isintended for temporary code alterations.

When composing Convey registrations, sometimes it's convenient to use instead of an actual func(). Not only does this skip the scope, but it provides an indication in the report that the registration is not complete, and that it's likely your code is missing some test coverage.

And like SkipConvey, this function is only intended for use duringtemporary code alterations.

You can use FocusConvey to only run certain registrations.

You must mark at least one leaf Convey registration (where the actual assertions are) and all of its parent Conveys in order for it to work.

You might want to run all subtests of a certain Convey registration. In that case every leaf test must be marked with Convey, along with all of its parents.

Here's an example of a common mistake:

Read more in