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
|
/*
* Copyright (C) 2010 Google Inc. All rights reserved.
* Copyright (C) 2012-2019 Apple Inc. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are
* met:
*
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above
* copyright notice, this list of conditions and the following disclaimer
* in the documentation and/or other materials provided with the
* distribution.
* * Neither the name of Google Inc. nor the names of its
* contributors may be used to endorse or promote products derived from
* this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
#pragma once
#include "BlobPropertyBag.h"
#include "BlobURL.h"
#include "FileReaderLoader.h"
#include "ScriptExecutionContext.h"
#include "ScriptWrappable.h"
#include "SecurityOriginData.h"
#include "URLKeepingBlobAlive.h"
#include "URLRegistry.h"
#include <variant>
#include <wtf/IsoMalloc.h>
#include <wtf/URL.h>
namespace JSC {
class ArrayBufferView;
class ArrayBuffer;
}
namespace WebCore {
class Blob;
class BlobLoader;
class DeferredPromise;
class ReadableStream;
class ScriptExecutionContext;
class FragmentedSharedBuffer;
class WebCoreOpaqueRoot;
template<typename> class ExceptionOr;
using BlobPartVariant = std::variant<RefPtr<JSC::ArrayBufferView>, RefPtr<JSC::ArrayBuffer>, RefPtr<Blob>, String>;
class Blob : public ScriptWrappable, public URLRegistrable, public RefCounted<Blob>, public ActiveDOMObject {
WTF_MAKE_ISO_ALLOCATED_EXPORT(Blob, WEBCORE_EXPORT);
public:
static Ref<Blob> create(ScriptExecutionContext* context)
{
auto blob = adoptRef(*new Blob(context));
blob->suspendIfNeeded();
return blob;
}
static Ref<Blob> create(ScriptExecutionContext& context, Vector<BlobPartVariant>&& blobPartVariants, const BlobPropertyBag& propertyBag)
{
auto blob = adoptRef(*new Blob(context, WTFMove(blobPartVariants), propertyBag));
blob->suspendIfNeeded();
return blob;
}
static Ref<Blob> create(ScriptExecutionContext* context, Vector<uint8_t>&& data, const String& contentType)
{
auto blob = adoptRef(*new Blob(context, WTFMove(data), contentType));
blob->suspendIfNeeded();
return blob;
}
static Ref<Blob> deserialize(ScriptExecutionContext* context, const URL& srcURL, const String& type, long long size, long long memoryCost, const String& fileBackedPath)
{
ASSERT(Blob::isNormalizedContentType(type));
auto blob = adoptRef(*new Blob(deserializationContructor, context, srcURL, type, size, memoryCost, fileBackedPath));
blob->suspendIfNeeded();
return blob;
}
virtual ~Blob();
URL url() const { return m_internalURL; }
const String& type() const { return m_type; }
WEBCORE_EXPORT unsigned long long size() const;
virtual bool isFile() const { return false; }
// The checks described in the File API spec.
static bool isValidContentType(const String&);
// The normalization procedure described in the File API spec.
static String normalizedContentType(const String&);
#if ASSERT_ENABLED
static bool isNormalizedContentType(const String&);
static bool isNormalizedContentType(const CString&);
#endif
// URLRegistrable
URLRegistry& registry() const override;
Ref<Blob> slice(long long start, long long end, const String& contentType) const;
void text(Ref<DeferredPromise>&&);
void arrayBuffer(Ref<DeferredPromise>&&);
ExceptionOr<Ref<ReadableStream>> stream();
size_t memoryCost() const { return m_memoryCost; }
// Keeping the handle alive will keep the Blob data alive (but not the Blob object).
URLKeepingBlobAlive handle() const;
protected:
WEBCORE_EXPORT explicit Blob(ScriptExecutionContext*);
Blob(ScriptExecutionContext&, Vector<BlobPartVariant>&&, const BlobPropertyBag&);
Blob(ScriptExecutionContext*, Vector<uint8_t>&&, const String& contentType);
enum ReferencingExistingBlobConstructor { referencingExistingBlobConstructor };
Blob(ReferencingExistingBlobConstructor, ScriptExecutionContext*, const Blob&);
enum UninitializedContructor { uninitializedContructor };
Blob(UninitializedContructor, ScriptExecutionContext*, URL&&, String&& type);
enum DeserializationContructor { deserializationContructor };
Blob(DeserializationContructor, ScriptExecutionContext*, const URL& srcURL, const String& type, std::optional<unsigned long long> size, unsigned long long memoryCost, const String& fileBackedPath);
// For slicing.
Blob(ScriptExecutionContext*, const URL& srcURL, long long start, long long end, unsigned long long memoryCost, const String& contentType);
private:
void loadBlob(FileReaderLoader::ReadType, CompletionHandler<void(BlobLoader&)>&&);
// ActiveDOMObject.
const char* activeDOMObjectName() const override;
String m_type;
mutable std::optional<unsigned long long> m_size;
size_t m_memoryCost { 0 };
// This is an internal URL referring to the blob data associated with this object. It serves
// as an identifier for this blob. The internal URL is never used to source the blob's content
// into an HTML or for FileRead'ing, public blob URLs must be used for those purposes.
URL m_internalURL;
HashSet<std::unique_ptr<BlobLoader>> m_blobLoaders;
};
WebCoreOpaqueRoot root(Blob*);
} // namespace WebCore
|
