third_party/WebKit/Source/platform/loader/fetch/TextResourceDecoderOptions.h

// Copyright 2017 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef TextResourceDecoderOptions_h
#define TextResourceDecoderOptions_h

#include "platform/PlatformExport.h"
#include "platform/weborigin/KURL.h"
#include "platform/wtf/text/TextEncoding.h"

namespace blink {

class PLATFORM_EXPORT TextResourceDecoderOptions final {
 public:
  enum ContentType {
    kPlainTextContent,
    kHTMLContent,
    kJSONContent,
    kXMLContent,
    kCSSContent,
    kMaxContentType = kCSSContent
  };  // PlainText only checks for BOM.

  explicit TextResourceDecoderOptions(
      ContentType,
      const WTF::TextEncoding& default_encoding = WTF::TextEncoding());

  // Corresponds to utf-8 decode in Encoding spec:
  // https://encoding.spec.whatwg.org/#utf-8-decode.
  static TextResourceDecoderOptions CreateAlwaysUseUTF8ForText();

  static TextResourceDecoderOptions CreateWithAutoDetection(
      ContentType,
      const WTF::TextEncoding& default_encoding,
      const WTF::TextEncoding& hint_encoding,
      const KURL& hint_url);

  void SetUseLenientXMLDecoding() { use_lenient_xml_decoding_ = true; }
  void OverrideContentType(ContentType content_type) {
    if (encoding_detection_option_ != kAlwaysUseUTF8ForText)
      content_type_ = content_type;
  }

  static ContentType DetermineContentType(const String& mime_type);

  // TextResourceDecoder does three kind of encoding detection:
  // 1. By BOM,
  // 2. By Content if |content_type_| is not |kPlainTextContext|
  //    (e.g. <meta> tag for HTML), and
  // 3. By DetectTextEncoding().
  enum EncodingDetectionOption {
    // Use 1. + 2. + 3.
    kUseAllAutoDetection,

    // Use 1. + 2.
    kUseContentAndBOMBasedDetection,

    // Use None of them.
    // |content_type_| must be |kPlainTextContent| and
    // |default_encoding_| must be UTF8Encoding.
    // This doesn't change encoding based on BOMs, but still processes
    // utf-8 BOMs so that utf-8 BOMs don't appear in the decoded result.
    kAlwaysUseUTF8ForText
  };

  EncodingDetectionOption GetEncodingDetectionOption() const {
    return encoding_detection_option_;
  }
  ContentType GetContentType() const { return content_type_; }
  const WTF::TextEncoding& DefaultEncoding() const { return default_encoding_; }
  bool GetUseLenientXMLDecoding() const { return use_lenient_xml_decoding_; }

  const char* HintEncoding() const { return hint_encoding_; }
  const KURL& HintURL() const { return hint_url_; }
  const char* HintLanguage() const { return hint_language_; }

 private:
  TextResourceDecoderOptions(EncodingDetectionOption,
                             ContentType,
                             const WTF::TextEncoding& default_encoding,
                             const char* hint_encoding,
                             const KURL& hint_url);

  EncodingDetectionOption encoding_detection_option_;
  ContentType content_type_;
  WTF::TextEncoding default_encoding_;
  bool use_lenient_xml_decoding_;  // Don't stop on XML decoding errors.

  // Hints for DetectTextEncoding().
  // Only used when |encoding_detection_option_| == |kUseAllAutoDetection|.
  const char* hint_encoding_;
  KURL hint_url_;
  char hint_language_[3];
};

}  // namespace blink

#endif