marcortola / behat-seo-contexts

Behat extension for testing some On-Page SEO factors: meta title/description, canonical, hreflang, meta robots, robots.txt, redirects, sitemap validation, HTML validation, performance...

Behat SEO Contexts

Behat extension for testing some On-Page SEO factors.

Includes contexts for testing:

• title / meta description
• canonical
• hreflang
• meta robots
• robots.txt
• indexation: tests meta robots + robots.txt + X-Robots-Tag header
• redirects
• sitemap validation (inc. multilanguage)
• HTML validation
• assets performance
• accessibility
• UX
• more...

Installation

Basic requirements:

• PHP 7.1+
• Behat 3+
• Mink + Mink extension

How to install it

1. Install Composer
2. Execute:

$ composer require marcortola/behat-seo-contexts --dev

3. Add the Context you need to behat.yml:

# behat.yml
default:
    # ...
    suites:
        default:
          contexts:
            - MarcOrtola\BehatSEOContexts\Context\MetaContext
            - MarcOrtola\BehatSEOContexts\Context\LocalizationContext
            - MarcOrtola\BehatSEOContexts\Context\RobotsContext
            - MarcOrtola\BehatSEOContexts\Context\IndexationContext
            - MarcOrtola\BehatSEOContexts\Context\RedirectContext
            - MarcOrtola\BehatSEOContexts\Context\SitemapContext
            - MarcOrtola\BehatSEOContexts\Context\HTMLContext
            - MarcOrtola\BehatSEOContexts\Context\PerformanceContext
            - MarcOrtola\BehatSEOContexts\Context\SocialContext
            - MarcOrtola\BehatSEOContexts\Context\AccessibilityContext
            - MarcOrtola\BehatSEOContexts\Context\UXContext

Featured steps

MetaContext

Then the page canonical should not be empty
Then the page canonical should be :expectedCanonicalUrl
Then the page title should not be empty
Then the page title should be :expectedTitle
Then the page meta description should not be empty
Then the page meta description should be :expectedMetaDescription
Then the page meta robots should be noindex
Then the page meta robots should not be noindex

LocalizationContext

Then the page hreflang markup should be valid

RobotsContext

Given I am a :crawlerUserAgent crawler
Then I should not be able to crawl :resource
Then I should be able to crawl :resource
Then I should be able to get the sitemap URL

IndexationContext

Then the page should be indexable
Then the page should not be indexable

RedirectContext

Given I follow redirects
Given I do not follow redirects
Then I should be redirected to :url

SitemapContext

Given the sitemap :sitemapUrl
Then the sitemap should be valid
Then the index sitemap should be valid
Then the multilanguage sitemap should be valid
Then the index sitemap should have a child with URL :childSitemapUrl
Then /^the sitemap should have ([0-9]+) children$/
Then the multilanguage sitemap should pass Google validation
Then the sitemap URLs should be alive
Then /^(\d+) random sitemap URLs? should be alive$/

HTMLContext

Then the page HTML markup should be valid
Then /^the page HTML5 doctype declaration should (not |)be valid$

PerformanceContext

Then /^browser cache should be enabled for (.+\..+|external|internal) (png|jpeg|gif|ico|js|css) resources$/
Then /^Javascript code should load (async|defer)$/
Then HTML code should be minified
Then CSS code should be minified
Then Javascript code should be minified
Then CSS code should load deferred
Then critical CSS code should exist in head

SocialContext

Then /^the (Twitter|Facebook) Open Graph data should satisfy (minimum|full) requirements$/

AccessibilityContext

Then the images should have alt text

UXContext

Then the site should be responsive
Then the site should not be responsive

Examples

This library is self-tested, and you can find examples inside the features directory. Feel free to explore it to discover each step definition.

Useful tips

• Use Symfony KernelDriver for improving the performance if you are working in a Symfony project.

behat-seo-contexts's Issues

Remove assertValidSitemap into dedicated step

In the very first sitemap step public function theSitemap which is needed for all subsequent steps the sitemap gets validated rather strictly against multiple schemas. Which is a real cool thing, but let's better make that a dedicated step.

Because the validation simply is too strict, I think. Assuming a sample sitemap without the initial <?xml> tag for example, this will simply fail the strict validation. But still it may be a valid sitemap, eaten by Google without any problem, and which URLs still can be checked afterwards in the public function theSitemapUrlsAreAlive step without any problem.

Add some tests

Why the rebranding?

Glad I found the package again, thought it was lost forever.

It was initially named novecode/behat-website-contexts, right?

Keep up the good work!

Incorrect namespace in readme

Hey mate,

Using this lib and following the instructions in the readme shows;

MarcOrtola\BehatSEOContexts\Context\

as the namespace. Looks like you've declared;

MOrtola\BehatSEOContexts\Context\

instead.

Thanks!

Meta Tag context enhancement

Meta Tag context enhancement to include following :

1. Alternative Text Tag
2. Responsive Design Meta Tag
3. Robots tag - validating nofollow value

cc- @marcortola

Add step to check given number of random sitemap URLs

@Then the sitemap URLs are alive can become a pretty time-consuming step given a huge sitemap of let's say 1000 URLs.

Let's add a step that checks only a given number of random URLs to reduce the time this step will take.