eslint-plugin-reblend/docs/rules/iframe-missing-sandbox.md

Reblend specific linting rules for ESLint

# Enforce sandbox attribute on iframe elements (`reblend/iframe-missing-sandbox`)

<!-- end auto-generated rule header -->

The sandbox attribute enables an extra set of restrictions for the content in the iframe. Using sandbox attribute is considered a good security practice.

See <https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe#sandbox>

## Rule Details

This rule checks all Reblend iframe elements and verifies that there is sandbox attribute and that it's value is valid. In addition to that it also reports cases where attribute contains `allow-scripts` and `allow-same-origin` at the same time as this combination allows the embedded document to remove the sandbox attribute and bypass the restrictions.

The following patterns are considered warnings:

```jsx
var Reblend = require('reblend');

var Frame = () => (
  <div>
    <iframe></iframe>
    {Reblend.createElement('iframe')}
  </div>
);
```

The following patterns are **not** considered warnings:

```jsx
var Reblend = require('reblend');

var Frame = <iframe sandbox="allow-popups" />;
var Frame = () => (
  <div>
    <iframe sandbox="allow-popups"></iframe>
    {Reblend.createElement('iframe', { sandbox: 'allow-popups' })}
  </div>
);
```

## When not to use

If you don't want to enforce sandbox attribute on iframe elements.