MIME (mime v1.6.0) View Source

Maps MIME types to its file extensions and vice versa.

MIME types can be extended in your application configuration as follows:

config :mime, :types, %{
  "application/vnd.api+json" => ["json-api"]
}

After adding the configuration, MIME needs to be recompiled. If you are using mix, it can be done with:

$ mix deps.clean mime --build

Link to this section Summary

Functions

compiled_custom_types()

Returns the custom types compiled into the MIME module.

extensions(type)

Returns the extensions associated with a given MIME type.

from_path(path)

Guesses the MIME type based on the path's extension. See type/1.

has_type?(file_extension)

Returns whether an extension has a MIME type registered.

type(file_extension)

Returns the MIME type associated with a file extension.

Link to this section Functions

compiled_custom_types()

Returns the custom types compiled into the MIME module.

extensions(type)

Specs

extensions(String.t()) :: [String.t()]

Returns the extensions associated with a given MIME type.

Examples

iex> MIME.extensions("text/html")
["html", "htm"]

iex> MIME.extensions("application/json")
["json"]

iex> MIME.extensions("application/vnd.custom+xml")
["xml"]

iex> MIME.extensions("foo/bar")
[]

from_path(path)

Specs

from_path(Path.t()) :: String.t()

Guesses the MIME type based on the path's extension. See type/1.

Examples

iex> MIME.from_path("index.html")
"text/html"

has_type?(file_extension)

Specs

has_type?(String.t()) :: boolean()

Returns whether an extension has a MIME type registered.

Examples

iex> MIME.has_type?("txt")
true

iex> MIME.has_type?("foobarbaz")
false

type(file_extension)

Specs

type(String.t()) :: String.t()

Returns the MIME type associated with a file extension.

If no MIME type is known for file_extension, "application/octet-stream" is returned.

Examples

iex> MIME.type("txt")
"text/plain"

iex> MIME.type("foobarbaz")
"application/octet-stream"