summaryrefslogtreecommitdiffstats
path: root/parser/html/nsHtml5SpeculativeLoad.h
blob: 1f4a61741612e077a74a57c4498a93acf3c0d4d7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
 
#ifndef nsHtml5SpeculativeLoad_h
#define nsHtml5SpeculativeLoad_h

#include "nsString.h"
#include "nsContentUtils.h"

class nsHtml5TreeOpExecutor;

enum eHtml5SpeculativeLoad
{
#ifdef DEBUG
  eSpeculativeLoadUninitialized,
#endif
  eSpeculativeLoadBase,
  eSpeculativeLoadCSP,
  eSpeculativeLoadMetaReferrer,
  eSpeculativeLoadImage,
  eSpeculativeLoadOpenPicture,
  eSpeculativeLoadEndPicture,
  eSpeculativeLoadPictureSource,
  eSpeculativeLoadScript,
  eSpeculativeLoadScriptFromHead,
  eSpeculativeLoadNoModuleScript,
  eSpeculativeLoadNoModuleScriptFromHead,
  eSpeculativeLoadStyle,
  eSpeculativeLoadManifest,
  eSpeculativeLoadSetDocumentCharset,
  eSpeculativeLoadSetDocumentMode,
  eSpeculativeLoadPreconnect
};

class nsHtml5SpeculativeLoad {
  public:
    nsHtml5SpeculativeLoad();
    ~nsHtml5SpeculativeLoad();

    inline void InitBase(nsHtml5String aUrl)
    {
      NS_PRECONDITION(mOpCode == eSpeculativeLoadUninitialized,
                      "Trying to reinitialize a speculative load!");
      mOpCode = eSpeculativeLoadBase;
      aUrl.ToString(mUrl);
    }

    inline void InitMetaCSP(nsHtml5String aCSP)
    {
      NS_PRECONDITION(mOpCode == eSpeculativeLoadUninitialized,
                      "Trying to reinitialize a speculative load!");
      mOpCode = eSpeculativeLoadCSP;
      nsString csp; // Not Auto, because using it to hold nsStringBuffer*
      aCSP.ToString(csp);
      mMetaCSP.Assign(
        nsContentUtils::TrimWhitespace<nsContentUtils::IsHTMLWhitespace>(csp));
    }

    inline void InitMetaReferrerPolicy(nsHtml5String aReferrerPolicy)
    {
      NS_PRECONDITION(mOpCode == eSpeculativeLoadUninitialized,
                      "Trying to reinitialize a speculative load!");
      mOpCode = eSpeculativeLoadMetaReferrer;
      nsString
        referrerPolicy; // Not Auto, because using it to hold nsStringBuffer*
      aReferrerPolicy.ToString(referrerPolicy);
      mReferrerPolicy.Assign(
        nsContentUtils::TrimWhitespace<nsContentUtils::IsHTMLWhitespace>(
          referrerPolicy));
    }

    inline void InitImage(nsHtml5String aUrl,
                          nsHtml5String aCrossOrigin,
                          nsHtml5String aReferrerPolicy,
                          nsHtml5String aSrcset,
                          nsHtml5String aSizes)
    {
      NS_PRECONDITION(mOpCode == eSpeculativeLoadUninitialized,
                      "Trying to reinitialize a speculative load!");
      mOpCode = eSpeculativeLoadImage;
      aUrl.ToString(mUrl);
      aCrossOrigin.ToString(mCrossOrigin);
      nsString
        referrerPolicy; // Not Auto, because using it to hold nsStringBuffer*
      aReferrerPolicy.ToString(referrerPolicy);
      mReferrerPolicy.Assign(
        nsContentUtils::TrimWhitespace<nsContentUtils::IsHTMLWhitespace>(
          referrerPolicy));
      aSrcset.ToString(mSrcset);
      aSizes.ToString(mSizes);
    }

    // <picture> elements have multiple <source> nodes followed by an <img>,
    // where we use the first valid source, which may be the img. Because we
    // can't determine validity at this point without parsing CSS and getting
    // main thread state, we push preload operations for picture pushed and
    // popped, so that the target of the preload ops can determine what picture
    // and nesting level each source/img from the main preloading code exists
    // at.
    inline void InitOpenPicture()
    {
      NS_PRECONDITION(mOpCode == eSpeculativeLoadUninitialized,
                      "Trying to reinitialize a speculative load!");
      mOpCode = eSpeculativeLoadOpenPicture;
    }

    inline void InitEndPicture()
    {
      NS_PRECONDITION(mOpCode == eSpeculativeLoadUninitialized,
                      "Trying to reinitialize a speculative load!");
      mOpCode = eSpeculativeLoadEndPicture;
    }

    inline void InitPictureSource(nsHtml5String aSrcset,
                                  nsHtml5String aSizes,
                                  nsHtml5String aType,
                                  nsHtml5String aMedia)
    {
      NS_PRECONDITION(mOpCode == eSpeculativeLoadUninitialized,
                      "Trying to reinitialize a speculative load!");
      mOpCode = eSpeculativeLoadPictureSource;
      aSrcset.ToString(mSrcset);
      aSizes.ToString(mSizes);
      aType.ToString(mTypeOrCharsetSourceOrDocumentMode);
      aMedia.ToString(mMedia);
    }

    inline void InitScript(nsHtml5String aUrl,
                           nsHtml5String aCharset,
                           nsHtml5String aType,
                           nsHtml5String aCrossOrigin,
                           nsHtml5String aIntegrity,
                           bool aParserInHead,
                           bool aAsync,
                           bool aDefer,
                           bool aNoModule)
    {
      NS_PRECONDITION(mOpCode == eSpeculativeLoadUninitialized,
                      "Trying to reinitialize a speculative load!");
      if (aNoModule) {
          mOpCode = aParserInHead ? eSpeculativeLoadNoModuleScriptFromHead
                                  : eSpeculativeLoadNoModuleScript;
      } else {
          mOpCode = aParserInHead ? eSpeculativeLoadScriptFromHead
                                  : eSpeculativeLoadScript;
      }
      aUrl.ToString(mUrl);
      aCharset.ToString(mCharset);
      aType.ToString(mTypeOrCharsetSourceOrDocumentMode);
      aCrossOrigin.ToString(mCrossOrigin);
      aIntegrity.ToString(mIntegrity);
      mIsAsync = aAsync;
      mIsDefer = aDefer;
    }

    inline void InitStyle(nsHtml5String aUrl,
                          nsHtml5String aCharset,
                          nsHtml5String aCrossOrigin,
                          nsHtml5String aIntegrity)
    {
      NS_PRECONDITION(mOpCode == eSpeculativeLoadUninitialized,
                      "Trying to reinitialize a speculative load!");
      mOpCode = eSpeculativeLoadStyle;
      aUrl.ToString(mUrl);
      aCharset.ToString(mCharset);
      aCrossOrigin.ToString(mCrossOrigin);
      aIntegrity.ToString(mIntegrity);
    }

    /**
     * "Speculative" manifest loads aren't truly speculative--if a manifest
     * gets loaded, we are committed to it. There can never be a <script>
     * before the manifest, so the situation of having to undo a manifest due
     * to document.write() never arises. The reason why a parser
     * thread-discovered manifest gets loaded via the speculative load queue
     * as opposed to tree operation queue is that the manifest must get
     * processed before any actual speculative loads such as scripts. Thus,
     * manifests seen by the parser thread have to maintain the queue order
     * relative to true speculative loads. See bug 541079.
     */
    inline void InitManifest(nsHtml5String aUrl)
    {
      NS_PRECONDITION(mOpCode == eSpeculativeLoadUninitialized,
                      "Trying to reinitialize a speculative load!");
      mOpCode = eSpeculativeLoadManifest;
      aUrl.ToString(mUrl);
    }

    /**
     * "Speculative" charset setting isn't truly speculative. If the charset
     * is set via this operation, we are committed to it unless chardet or
     * a late meta cause a reload. The reason why a parser
     * thread-discovered charset gets communicated via the speculative load
     * queue as opposed to tree operation queue is that the charset change
     * must get processed before any actual speculative loads such as style
     * sheets. Thus, encoding decisions by the parser thread have to maintain
     * the queue order relative to true speculative loads. See bug 675499.
     */
    inline void InitSetDocumentCharset(nsACString& aCharset,
                                       int32_t aCharsetSource)
    {
      NS_PRECONDITION(mOpCode == eSpeculativeLoadUninitialized,
                      "Trying to reinitialize a speculative load!");
      mOpCode = eSpeculativeLoadSetDocumentCharset;
      CopyUTF8toUTF16(aCharset, mCharset);
      mTypeOrCharsetSourceOrDocumentMode.Assign((char16_t)aCharsetSource);
    }

    /**
     * Speculative document mode setting isn't really speculative. Once it
     * happens, we are committed to it. However, this information needs to
     * travel in the speculation queue in order to have this information
     * available before parsing the speculatively loaded style sheets.
     */
    inline void InitSetDocumentMode(nsHtml5DocumentMode aMode)
    {
      NS_PRECONDITION(mOpCode == eSpeculativeLoadUninitialized,
                      "Trying to reinitialize a speculative load!");
      mOpCode = eSpeculativeLoadSetDocumentMode;
      mTypeOrCharsetSourceOrDocumentMode.Assign((char16_t)aMode);
    }

    inline void InitPreconnect(nsHtml5String aUrl, nsHtml5String aCrossOrigin)
    {
      NS_PRECONDITION(mOpCode == eSpeculativeLoadUninitialized,
                      "Trying to reinitialize a speculative load!");
      mOpCode = eSpeculativeLoadPreconnect;
      aUrl.ToString(mUrl);
      aCrossOrigin.ToString(mCrossOrigin);
    }

    void Perform(nsHtml5TreeOpExecutor* aExecutor);

  private:
    eHtml5SpeculativeLoad mOpCode;

    /**
     * Whether the refering element has async and/or defer attributes.
     */
    bool mIsAsync;
    bool mIsDefer;

    nsString mUrl;
    nsString mReferrerPolicy;
    nsString mMetaCSP;

    /**
     * If mOpCode is eSpeculativeLoadStyle or eSpeculativeLoadScript[FromHead]
     * then this is the value of the "charset" attribute. For
     * eSpeculativeLoadSetDocumentCharset it is the charset that the
     * document's charset is being set to. Otherwise it's empty.
     */
    nsString mCharset;
    /**
     * If mOpCode is eSpeculativeLoadSetDocumentCharset, this is a
     * one-character string whose single character's code point is to be
     * interpreted as a charset source integer. If mOpCode is
     * eSpeculativeLoadSetDocumentMode, this is a one-character string whose
     * single character's code point is to be interpreted as an
     * nsHtml5DocumentMode. Otherwise, it is empty or the value of the type
     * attribute.
     */
    nsString mTypeOrCharsetSourceOrDocumentMode;
    /**
     * If mOpCode is eSpeculativeLoadImage or eSpeculativeLoadScript[FromHead]
     * or eSpeculativeLoadPreconnect this is the value of the "crossorigin"
     * attribute.  If the attribute is not set, this will be a void string.
     */
    nsString mCrossOrigin;
    /**
     * If mOpCode is eSpeculativeLoadImage or eSpeculativeLoadPictureSource,
     * this is the value of "srcset" attribute.  If the attribute is not set,
     * this will be a void string.
     */
    nsString mSrcset;
    /**
     * If mOpCode is eSpeculativeLoadPictureSource, this is the value of "sizes"
     * attribute.  If the attribute is not set, this will be a void string.
     */
    nsString mSizes;
    /**
     * If mOpCode is eSpeculativeLoadPictureSource, this is the value of "media"
     * attribute.  If the attribute is not set, this will be a void string.
     */
    nsString mMedia;
    /**
     * If mOpCode is eSpeculativeLoadScript[FromHead], this is the value of the
     * "integrity" attribute.  If the attribute is not set, this will be a void
     * string.
     */
    nsString mIntegrity;
};

#endif // nsHtml5SpeculativeLoad_h