What is MIME type "text/x-gherkin"?

A MIME type is a string that tells browsers and other tools how to handle a particular kind of file.

MIME type text/x-gherkin indicates plain text files that follow the Gherkin language syntax. This language is used to define software features in a structured and clear way.

It is popular in behavior-driven development (BDD) frameworks. The language lets teams write test scenarios in a human-readable form that also serves as executable tests.

Describes software behavior through scenarios and steps.
Bridges the gap between non-technical stakeholders and developers.
Integrates naturally with automation tools like Cucumber.

Such files are commonly saved with an FEATURE extension. This helps tools identify and process the file correctly.

For more details on the Gherkin language, visit Cucumber Gherkin documentation.

Associated file extensions

.feature

Usage Examples

HTTP Header

When serving content with this MIME type, set the Content-Type header:


    Content-Type: text/x-gherkin

HTML

In HTML, you can specify the MIME type in various elements:


    <a href="file.dat" type="text/x-gherkin">Download file</a>

Server-side (Node.js)

Setting the Content-Type header in Node.js:


    const http = require('http');    
    
    http.createServer((req, res) => {    
      res.setHeader('Content-Type', 'text/x-gherkin');    
      res.end('Content here');    
    }).listen(3000);

Associated file extensions

.feature

FAQs

What is the primary use of the text/x-gherkin MIME type?

This MIME type is used to identify files written in the Gherkin language, typically associated with the .feature extension. It is essential for Behavior-Driven Development (BDD) tools like Cucumber to parse test scenarios that describe software behavior in plain English.

How do I configure my web server to serve .feature files correctly?

You must map the extension to the MIME type in your server configuration. For Apache, add AddType text/x-gherkin .feature to your .htaccess or config file. For Nginx, add text/x-gherkin feature; inside the types { } block in mime.types or nginx.conf.

Why does the MIME type start with 'text/x-'?

The x- prefix indicates that text/x-gherkin is a non-standard or experimental type not officially registered with IANA. However, it is the de facto standard used by developers and tools to distinguish Gherkin syntax from standard text/plain files.

Can I open text/x-gherkin files in a web browser?

Most browsers will display the file as raw text or prompt you to download it, as they do not have built-in rendering engines for Gherkin syntax. To view these files with proper syntax highlighting, it is better to use a code editor like VS Code or IntelliJ IDEA with a Gherkin plugin.

Is it safe to use text/plain instead of text/x-gherkin?

Yes, serving .feature files as text/plain is safe and ensures the content is readable in browsers. However, using the specific text/x-gherkin type is preferred in development environments because it allows IDEs and automation tools to automatically detect the language and apply syntax formatting.

Are text/x-gherkin files executable scripts?

No, files with the feature extension are strictly plain text documents. They do not contain executable binary code; instead, a test runner (like Cucumber) reads the text and matches the described steps to underlying code definitions to execute tests.

General FAQ

What is a MIME type?

A MIME (Multipurpose Internet Mail Extensions) type is a standard that indicates the nature and format of a document, file, or assortment of bytes. MIME types are defined and standardized in IETF's RFC 6838.

MIME types are important because they help browsers and servers understand how to process a file. When a browser receives a file from a server, it uses the MIME type to determine how to display or handle the content, whether it's an image to display, a PDF to open in a viewer, or a video to play.

MIME types consist of a type and a subtype, separated by a slash (e.g., text/html, image/jpeg, application/pdf). Some MIME types also include optional parameters.

How do I find the MIME type for a file?

You can check the file extension or use a file identification tool such as file --mime-type on the command line. Many programming languages also provide libraries to detect MIME types.

Why are multiple MIME types listed for one extension?

Different applications and historical conventions may use alternative MIME identifiers for the same kind of file. Showing them all helps ensure compatibility across systems.