---
name: "vmod_accept"
section: "3"
platform: "linux"
package: "varnish-modules"
version: "0.25.0-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/vmod_accept"
---

# vmod\_accept(3)

Accept VMOD

## NAME

vmod\_accept - Accept VMOD

## SYNOPSIS

```
import accept [as name] [from "path"]
new xrule = accept.rule(STRING string)
    VOID xrule.add(STRING string)
    VOID xrule.remove(STRING string)
    STRING xrule.filter(STRING string)
```

## DESCRIPTION

accept allows you to sanitize the Accept\* headers (mainly Accept, Accept-Charset and Accept-Encoding) by specify one fallback string, and then adding valid values:

```
sub vcl_init {
    new rule = accept.rule("text/plain");
    rule.add("text/html");
    rule.add("application/json");
}
```

You can then use the **rule** object to filter the headers. The following line will set the accept header to "text/html" or "application/json" if any of them is found in the original header, and will set it to "text/plain" if neither is found:

```
sub vcl_recv {
    set req.http.Accept = rule.filter(req.http.Accept);
}
```

accept will ignore any parameter found and will just return the first choice found. More info here:  \<https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html\>

## API

### new xrule = accept.rule(STRING string)

Create a rule object, setting the fallback string.

### VOID xrule.add(STRING string)

Add **string** to the list of valid choices.

### VOID xrule.remove(STRING string)

Remove **string** to the list of valid choices.

### STRING xrule.filter(STRING string)

Parse string and try to find a valid choice. The first one found is returned (they are tested in the same order they were added), otherwise, the fallback string is returned.

## COPYRIGHT

```
Copyright (c) 2016 Guillaume Quintard
Author: Guillaume Quintard <guillaume.quintard@gmail.com>
(vmodtool requires this format.)
```