Codeception Yandex Module
, (*1)
This package provides validation of responses via Structured data validator API
from Yandex. You can automatically check if your embedded structured data
markup (aka semantic markup) is correct based on the current vocabularies like schema.org., (*2)
To transmit data to the API, you specify the HTML code or URL of the page. After completing validation, the API outputs
the structured data extracted from the page in JSON format, > along with the codes of any errors detected. The following
syntaxes are currently supported: JSON-LD, RDFa, microdata, and microformats., (*3)
Source: https://tech.yandex.com/validator/, (*4)
With this module you are able to automate tests for semantic data validation in your cests via codeception.
You save time during development of new features, because you do not have to copy your markup manually into the
structured data testing tool or
structured data validator when checking if some new feature or bugfix
break your semantic markup., (*5)
You also can use this module for automating structured data validation for large quantities of pages., (*6)
Installation
You need to add the repository into your composer.json file, (*7)
composer require --dev portrino/codeception-yandex-module
Usage
You can use this module as any other Codeception module, by adding 'Yandex' to the enabled modules in your Codeception suite configurations., (*8)
Enable module and setup the configuration variables
- After registering you can get the
apiKey here: https://developer.tech.yandex.ru/
- The
url could be set in config file directly or via an environment variable: %BASE_URL%
modules:
enabled:
- Yandex:
depends: PhpBrowser
url: ADD_YOUR_BASE_URL_HERE
apiKey: ADD_YOUR_API_KEY_HERE
```
Update Codeception build
```bash
codecept build
Implement the cept / cest
$I->wantToTest('If structured data for page is valid.');
$I->amOnPage('foo/bar/');
$I->seeResponseCodeIs(\Codeception\Util\HttpCode::OK); // 200
// validate all
$I->seeResponseContainsValidStructuredDataMarkup();
// validate only JSON+LD
$I->seeResponseContainsValidJsonLdMarkup();
// validate only Microdata
$I->seeResponseContainsValidMicrodataMarkup();
// validate only Microformat
$I->seeResponseContainsValidMicroformatMarkup();
// validate only Rdfa
$I->seeResponseContainsValidRdfaMarkup();
// grab the data array from Yandex API response
// @see: https://tech.yandex.com/validator/doc/dg/concepts/response_standart-docpage/
$data = $I->grabStructuredDataFromApiResponse()['json-ld'];
// grab the data from Yandex API response via jsonPath
// !Important: All chars like . // / and - are replaced by _ to make jsonPath working!
$I->assertEquals(
'foo.com',
$I->grabStructuredDataFromApiResponseByJsonPath('json_ld.0.http___schema_org_name.0._value')[0]
);
Methods
seeResponseContainsValidStructuredDataMarkup()
Validates the current response from $I->amOnPage('/foo/bar/'); against the structured data validator API and checks
all supported formats like: JSON-LD, RDFa, microdata, and microformats., (*9)
$I->seeResponseContainsValidStructuredDataMarkup();
seeResponseContainsValidJsonLdMarkup()
Validates the current response from $I->amOnPage('/foo/bar/'); against the structured data validator API and checks
only the data which is in JSON-LD format., (*10)
$I->seeResponseContainsValidJsonLdMarkup();
seeResponseContainsValidMicrodataMarkup()
Validates the current response from $I->amOnPage('/foo/bar/'); against the structured data validator API and checks
only the data which is in microdata format., (*11)
$I->seeResponseContainsValidMicrodataMarkup();
Validates the current response from $I->amOnPage('/foo/bar/'); against the structured data validator API and checks
only the data which is in microformat format., (*12)
$I->seeResponseContainsValidMicroformatMarkup();
seeResponseContainsValidRdfaMarkup()
Validates the current response from $I->amOnPage('/foo/bar/'); against the structured data validator API and checks
only the data which is in RDFa format., (*13)
$I->seeResponseContainsValidRdfaMarkup();
grabStructuredDataFromApiResponse()
Grab the structured data from the current response and it returns it as array. Please have a look at https://tech.yandex.com/validator/doc/dg/concepts/response_standart-docpage/
for information about the standard response format of the yandex API., (*14)
$data = $I->grabStructuredDataFromApiResponse();
grabStructuredDataFromApiResponseByJsonPath()
Experimental!!!, (*15)
Grab the structured data from the current response by jsonPath query syntax with the help of JSONPath PHP Package.
All "special" chars like:, (*16)
are replaced in json response from yandex structured data validator API by _ to make jsonPath working!, (*17)
$data = $I->grabStructuredDataFromApiResponseByJsonPath('json_ld.0.http___schema_org_name.0._value');
Authors
, (*18)
-
André Wuttig - Initial work, Unit Tests - aWuttig
See also the list of contributors who participated in this project., (*19)
Wallogit.com
