Eno\Section » assertAllTouched

assertAllTouched()
assertAllTouched($options)
assertAllTouched($message, $options)
assertAllTouched($message_function, $options)

Assert that all elements of this section (and also, recursively, of all subsections) that were present in the parsed eno document were also queried (and therefore touched) by the application. This, combined with eno's query methods, serves to ensure a two-way guarantee for both users and developers: No data that the application requires can be left out, and no data that the application does not process can be supplied.

enoImportant data A: I need to be processed!
Important data B: Me too!

php$document = Parser::parse($input);

$data_a = $document->field('Important data A');

// ... processing happens only for data_a

$document->assertAllTouched(); // throws a ValidationError with the default message

$document->assertAllTouched([ 'only' => ['Important data A'] ]);  // passes
$document->assertAllTouched([ 'except' => ['Important data B'] ]);  // passes

$document->assertAllTouched(function($name, $value) {  // throws a ValidationError "Important data B is not ..."
  return "{$name} is not supported by the application, please contact support if you think it should be"
});

Parameters

Optional, usually the default message (An excess element named [NAME] was found, is it possibly a typo?) will do fine. If you want to override it, provide either a static message as a string, or alternatively a function returning a string. (The function is passed $name and $value in that order, although $value can be null if the untouched element is a fieldset or section)

only

An array of strings, e.g. ['name', 'email'], which specifies to only check these elements for whether they've been touched.

except

An array of strings, e.g. ['phone number'], which specifies to exclude these elements from checking whether they've been touched.