[Streams API] ReadableStream constructor start function should be able to error the...
[WebKit-https.git] / Source / WebCore / Modules / streams / ReadableStreamReader.h
1 /*
2  * Copyright (C) 2015 Canon Inc.
3  * Copyright (C) 2015 Igalia S.L.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted, provided that the following conditions
7  * are required to be met:
8  *
9  * 1.  Redistributions of source code must retain the above copyright
10  *     notice, this list of conditions and the following disclaimer.
11  * 2.  Redistributions in binary form must reproduce the above copyright
12  *     notice, this list of conditions and the following disclaimer in the
13  *     documentation and/or other materials provided with the distribution.
14  * 3.  Neither the name of Canon Inc. nor the names of
15  *     its contributors may be used to endorse or promote products derived
16  *     from this software without specific prior written permission.
17  *
18  * THIS SOFTWARE IS PROVIDED BY CANON INC. AND ITS CONTRIBUTORS "AS IS" AND ANY
19  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
20  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
21  * DISCLAIMED. IN NO EVENT SHALL CANON INC. AND ITS CONTRIBUTORS BE LIABLE FOR
22  * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
24  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
25  * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
26  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
27  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28  */
29
30 #ifndef ReadableStreamReader_h
31 #define ReadableStreamReader_h
32
33 #if ENABLE(STREAMS_API)
34
35 #include "ActiveDOMObject.h"
36 #include "ReadableStream.h"
37 #include "ScriptWrappable.h"
38 #include <functional>
39 #include <runtime/JSCJSValue.h>
40 #include <wtf/Ref.h>
41 #include <wtf/RefCounted.h>
42
43 namespace WebCore {
44
45 // ReadableStreamReader implements the core of the streams API ReadableStreamReader functionality.
46 // It handles in particular access to the chunks and state of a ReadableStream.
47 // See https://streams.spec.whatwg.org/#reader-class for more information.
48 class ReadableStreamReader : public ActiveDOMObject, public ScriptWrappable, public RefCounted<ReadableStreamReader> {
49 public:
50     enum class State {
51         Readable,
52         Closed,
53         Errored
54     };
55
56     virtual ~ReadableStreamReader();
57
58     ReadableStream* stream() { return m_stream.get(); }
59
60     typedef std::function<void()> ClosedSuccessCallback;
61     typedef std::function<void()> ClosedErrorCallback;
62     void closed(ClosedSuccessCallback, ClosedErrorCallback);
63
64     void changeStateToClosed();
65     void changeStateToErrored();
66
67     virtual JSC::JSValue error() = 0;
68
69 protected:
70     ReadableStreamReader(ReadableStream&);
71
72     void releaseStream();
73
74 private:
75     // ActiveDOMObject API.
76     const char* activeDOMObjectName() const override;
77     bool canSuspendForPageCache() const override;
78     void initialize();
79
80     RefPtr<ReadableStream> m_stream;
81     State m_state { State::Readable };
82
83     ClosedSuccessCallback m_closedSuccessCallback;
84     ClosedErrorCallback m_closedErrorCallback;
85 };
86
87 }
88
89 #endif
90
91 #endif // ReadableStream_h