1
// Copyright (c) 2012 The Chromium Authors. All rights reserved.
2
// Use of this source code is governed by a BSD-style license that can be
3
// found in the LICENSE file.
5
#ifndef NET_BASE_MIME_UTIL_H__
6
#define NET_BASE_MIME_UTIL_H__
11
#include "base/files/file_path.h"
12
#include "net/base/net_export.h"
16
// Get the mime type (if any) that is associated with the given file extension.
17
// Returns true if a corresponding mime type exists.
18
NET_EXPORT bool GetMimeTypeFromExtension(const base::FilePath::StringType& ext,
19
std::string* mime_type);
21
// Get the mime type (if any) that is associated with the given file extension.
22
// Returns true if a corresponding mime type exists. In this method,
23
// the search for a mime type is constrained to a limited set of
24
// types known to the net library, the OS/registry is not consulted.
25
NET_EXPORT bool GetWellKnownMimeTypeFromExtension(
26
const base::FilePath::StringType& ext,
27
std::string* mime_type);
29
// Get the mime type (if any) that is associated with the given file. Returns
30
// true if a corresponding mime type exists.
31
NET_EXPORT bool GetMimeTypeFromFile(const base::FilePath& file_path,
32
std::string* mime_type);
34
// Get the preferred extension (if any) associated with the given mime type.
35
// Returns true if a corresponding file extension exists. The extension is
36
// returned without a prefixed dot, ex "html".
37
NET_EXPORT bool GetPreferredExtensionForMimeType(
38
const std::string& mime_type,
39
base::FilePath::StringType* extension);
41
// Check to see if a particular MIME type is in our list.
42
NET_EXPORT bool IsSupportedImageMimeType(const std::string& mime_type);
43
NET_EXPORT bool IsSupportedMediaMimeType(const std::string& mime_type);
44
NET_EXPORT bool IsSupportedNonImageMimeType(const std::string& mime_type);
45
NET_EXPORT bool IsUnsupportedTextMimeType(const std::string& mime_type);
46
NET_EXPORT bool IsSupportedJavascriptMimeType(const std::string& mime_type);
47
NET_EXPORT bool IsSupportedCertificateMimeType(const std::string& mime_type);
49
// Convenience function.
50
NET_EXPORT bool IsSupportedMimeType(const std::string& mime_type);
52
// Returns true if this the mime_type_pattern matches a given mime-type.
53
// Checks for absolute matching and wildcards. mime-types should be in
55
NET_EXPORT bool MatchesMimeType(const std::string& mime_type_pattern,
56
const std::string& mime_type);
58
// Returns true if the |type_string| is a correctly-formed mime type specifier.
59
// Allows strings of the form x/y[;params], where "x" is a legal mime type name.
60
// Also allows wildcard types -- "x/*", "*/*", and "*".
61
NET_EXPORT bool IsMimeType(const std::string& type_string);
63
// Returns true if and only if all codecs are supported, false otherwise.
64
NET_EXPORT bool AreSupportedMediaCodecs(const std::vector<std::string>& codecs);
66
// Parses a codec string, populating |codecs_out| with the prefix of each codec
67
// in the string |codecs_in|. For example, passed "aaa.b.c,dd.eee", if
68
// |strip| == true |codecs_out| will contain {"aaa", "dd"}, if |strip| == false
69
// |codecs_out| will contain {"aaa.b.c", "dd.eee"}.
70
// See http://www.ietf.org/rfc/rfc4281.txt.
71
NET_EXPORT void ParseCodecString(const std::string& codecs,
72
std::vector<std::string>* codecs_out,
75
// Check to see if a particular MIME type is in our list which only supports a
76
// certain subset of codecs.
77
NET_EXPORT bool IsStrictMediaMimeType(const std::string& mime_type);
79
// Check to see if a particular MIME type is in our list which only supports a
80
// certain subset of codecs. Returns true if and only if all codecs are
81
// supported for that specific MIME type, false otherwise. If this returns
82
// false you will still need to check if the media MIME tpyes and codecs are
84
NET_EXPORT bool IsSupportedStrictMediaMimeType(
85
const std::string& mime_type,
86
const std::vector<std::string>& codecs);
88
// Get the extensions associated with the given mime type. This should be passed
89
// in lower case. There could be multiple extensions for a given mime type, like
90
// "html,htm" for "text/html", or "txt,text,html,..." for "text/*".
91
// Note that we do not erase the existing elements in the the provided vector.
92
// Instead, we append the result to it.
93
NET_EXPORT void GetExtensionsForMimeType(
94
const std::string& mime_type,
95
std::vector<base::FilePath::StringType>* extensions);
97
// Test only method that removes proprietary media types and codecs from the
98
// list of supported MIME types and codecs. These types and codecs must be
99
// removed to ensure consistent layout test results across all Chromium
101
NET_EXPORT void RemoveProprietaryMediaTypesAndCodecsForTests();
103
// Returns the IANA media type contained in |mime_type|, or an empty
104
// string if |mime_type| does not specifify a known media type.
105
// Supported media types are defined at:
106
// http://www.iana.org/assignments/media-types/index.html
107
NET_EXPORT const std::string GetIANAMediaType(const std::string& mime_type);
109
// A list of supported certificate-related mime types.
110
enum CertificateMimeType {
111
#define CERTIFICATE_MIME_TYPE(name, value) CERTIFICATE_MIME_TYPE_ ## name = value,
112
#include "net/base/mime_util_certificate_type_list.h"
113
#undef CERTIFICATE_MIME_TYPE
116
NET_EXPORT CertificateMimeType GetCertificateMimeTypeForMimeType(
117
const std::string& mime_type);
119
// Prepares one value as part of a multi-part upload request.
120
NET_EXPORT void AddMultipartValueForUpload(const std::string& value_name,
121
const std::string& value,
122
const std::string& mime_boundary,
123
const std::string& content_type,
124
std::string* post_data);
126
// Adds the final delimiter to a multi-part upload request.
127
NET_EXPORT void AddMultipartFinalDelimiterForUpload(
128
const std::string& mime_boundary,
129
std::string* post_data);
133
#endif // NET_BASE_MIME_UTIL_H__