Bug Summary

File:var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/mozilla/ipc/ByteBuf.h
Warning:line 61, column 16
Attempt to free released memory

Annotated Source Code

Press '?' to see keyboard shortcuts

clang -cc1 -cc1 -triple x86_64-pc-linux-gnu -analyze -disable-free -clear-ast-before-backend -disable-llvm-verifier -discard-value-names -main-file-name nsIconChannel.cpp -analyzer-checker=core -analyzer-checker=apiModeling -analyzer-checker=unix -analyzer-checker=deadcode -analyzer-checker=cplusplus -analyzer-checker=security.insecureAPI.UncheckedReturn -analyzer-checker=security.insecureAPI.getpw -analyzer-checker=security.insecureAPI.gets -analyzer-checker=security.insecureAPI.mktemp -analyzer-checker=security.insecureAPI.mkstemp -analyzer-checker=security.insecureAPI.vfork -analyzer-checker=nullability.NullPassedToNonnull -analyzer-checker=nullability.NullReturnedFromNonnull -analyzer-output plist -w -setup-static-analyzer -analyzer-config-compatibility-mode=true -mrelocation-model pic -pic-level 2 -fhalf-no-semantic-interposition -mframe-pointer=all -relaxed-aliasing -ffp-contract=off -fno-rounding-math -mconstructor-aliases -funwind-tables=2 -target-cpu x86-64 -tune-cpu generic -debugger-tuning=gdb -fdebug-compilation-dir=/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/image/decoders/icon/gtk -fcoverage-compilation-dir=/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/image/decoders/icon/gtk -resource-dir /usr/lib/llvm-19/lib/clang/19 -include /var/lib/jenkins/workspace/firefox-scan-build/config/gcc_hidden.h -include /var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/mozilla-config.h -I /var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/stl_wrappers -I /var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/system_wrappers -U _FORTIFY_SOURCE -D _FORTIFY_SOURCE=2 -D DEBUG=1 -D MOZ_HAS_MOZGLUE -D MOZILLA_INTERNAL_API -D IMPL_LIBXUL -D MOZ_SUPPORT_LEAKCHECKING -D STATIC_EXPORTABLE_JS_API -I /var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk -I /var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/image/decoders/icon/gtk -I /var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/ipc/ipdl/_ipdlheaders -I /var/lib/jenkins/workspace/firefox-scan-build/ipc/chromium/src -I /var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include -I /var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nspr -I /var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nss -D MOZILLA_CLIENT -I /usr/include/gtk-3.0 -I /usr/include/pango-1.0 -I /usr/include/glib-2.0 -I /usr/lib/x86_64-linux-gnu/glib-2.0/include -I /usr/include/sysprof-6 -I /usr/include/harfbuzz -I /usr/include/freetype2 -I /usr/include/libpng16 -I /usr/include/libmount -I /usr/include/blkid -I /usr/include/fribidi -I /usr/include/cairo -I /usr/include/pixman-1 -I /usr/include/gdk-pixbuf-2.0 -I /usr/include/x86_64-linux-gnu -I /usr/include/webp -I /usr/include/gio-unix-2.0 -I /usr/include/cloudproviders -I /usr/include/atk-1.0 -I /usr/include/at-spi2-atk/2.0 -I /usr/include/at-spi-2.0 -I /usr/include/dbus-1.0 -I /usr/lib/x86_64-linux-gnu/dbus-1.0/include -I /usr/include/gtk-3.0/unix-print -internal-isystem /usr/lib/gcc/x86_64-linux-gnu/14/../../../../include/c++/14 -internal-isystem /usr/lib/gcc/x86_64-linux-gnu/14/../../../../include/x86_64-linux-gnu/c++/14 -internal-isystem /usr/lib/gcc/x86_64-linux-gnu/14/../../../../include/c++/14/backward -internal-isystem /usr/lib/llvm-19/lib/clang/19/include -internal-isystem /usr/local/include -internal-isystem /usr/lib/gcc/x86_64-linux-gnu/14/../../../../x86_64-linux-gnu/include -internal-externc-isystem /usr/include/x86_64-linux-gnu -internal-externc-isystem /include -internal-externc-isystem /usr/include -O2 -Wno-error=tautological-type-limit-compare -Wno-invalid-offsetof -Wno-range-loop-analysis -Wno-deprecated-anon-enum-enum-conversion -Wno-deprecated-enum-enum-conversion -Wno-deprecated-this-capture -Wno-inline-new-delete -Wno-error=deprecated-declarations -Wno-error=array-bounds -Wno-error=free-nonheap-object -Wno-error=atomic-alignment -Wno-error=deprecated-builtins -Wno-psabi -Wno-error=builtin-macro-redefined -Wno-vla-cxx-extension -Wno-unknown-warning-option -fdeprecated-macro -ferror-limit 19 -fstrict-flex-arrays=1 -stack-protector 2 -fstack-clash-protection -ftrivial-auto-var-init=pattern -fno-rtti -fgnuc-version=4.2.1 -fskip-odr-check-in-gmf -fno-sized-deallocation -fno-aligned-allocation -vectorize-loops -vectorize-slp -analyzer-checker optin.performance.Padding -analyzer-output=html -analyzer-config stable-report-filename=true -faddrsig -D__GCC_HAVE_DWARF2_CFI_ASM=1 -o /tmp/scan-build-2024-09-22-115206-3586786-1 -x c++ /var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp

/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp

1/* vim:set ts=2 sw=2 sts=2 cin et: */
2/* This Source Code Form is subject to the terms of the Mozilla Public
3 * License, v. 2.0. If a copy of the MPL was not distributed with this
4 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
5
6#include "nsIconChannel.h"
7
8#include <stdlib.h>
9#include <unistd.h>
10
11#include "mozilla/DebugOnly.h"
12#include "mozilla/EndianUtils.h"
13#include "mozilla/NullPrincipal.h"
14#include "mozilla/CheckedInt.h"
15#include "mozilla/dom/ContentChild.h"
16#include "mozilla/gfx/Swizzle.h"
17#include "mozilla/ipc/ByteBuf.h"
18#include <algorithm>
19
20#include <gio/gio.h>
21
22#include <gtk/gtk.h>
23
24#include "nsMimeTypes.h"
25#include "nsIMIMEService.h"
26
27#include "nsServiceManagerUtils.h"
28
29#include "nsNetUtil.h"
30#include "nsComponentManagerUtils.h"
31#include "nsIStringStream.h"
32#include "nsServiceManagerUtils.h"
33#include "nsIURL.h"
34#include "nsIPipe.h"
35#include "nsIAsyncInputStream.h"
36#include "nsIAsyncOutputStream.h"
37#include "prlink.h"
38#include "gfxPlatform.h"
39
40using mozilla::CheckedInt32;
41using mozilla::ipc::ByteBuf;
42
43NS_IMPL_ISUPPORTS(nsIconChannel, nsIRequest, nsIChannel)MozExternalRefCountType nsIconChannel::AddRef(void) { static_assert
(!std::is_destructible_v<nsIconChannel>, "Reference-counted class "
"nsIconChannel" " should not have a public destructor. " "Make this class's destructor non-public"
); do { static_assert( mozilla::detail::AssertionConditionType
<decltype(int32_t(mRefCnt) >= 0)>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(int32_t(mRefCnt) >= 0))),
0))) { do { } while (false); MOZ_ReportAssertionFailure("int32_t(mRefCnt) >= 0"
" (" "illegal refcnt" ")", "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 43); AnnotateMozCrashReason("MOZ_ASSERT" "(" "int32_t(mRefCnt) >= 0"
") (" "illegal refcnt" ")"); do { *((volatile int*)__null) =
43; __attribute__((nomerge)) ::abort(); } while (false); } }
while (false); do { static_assert( mozilla::detail::AssertionConditionType
<decltype("nsIconChannel" != nullptr)>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!("nsIconChannel" != nullptr))
), 0))) { do { } while (false); MOZ_ReportAssertionFailure("\"nsIconChannel\" != nullptr"
" (" "Must specify a name" ")", "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 43); AnnotateMozCrashReason("MOZ_ASSERT" "(" "\"nsIconChannel\" != nullptr"
") (" "Must specify a name" ")"); do { *((volatile int*)__null
) = 43; __attribute__((nomerge)) ::abort(); } while (false); }
} while (false); if (!mRefCnt.isThreadSafe) _mOwningThread.AssertOwnership
("nsIconChannel" " not thread-safe"); nsrefcnt count = ++mRefCnt
; NS_LogAddRef((this), (count), ("nsIconChannel"), (uint32_t)
(sizeof(*this))); return count; } MozExternalRefCountType nsIconChannel
::Release(void) { do { static_assert( mozilla::detail::AssertionConditionType
<decltype(int32_t(mRefCnt) > 0)>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(int32_t(mRefCnt) > 0))), 0
))) { do { } while (false); MOZ_ReportAssertionFailure("int32_t(mRefCnt) > 0"
" (" "dup release" ")", "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 43); AnnotateMozCrashReason("MOZ_ASSERT" "(" "int32_t(mRefCnt) > 0"
") (" "dup release" ")"); do { *((volatile int*)__null) = 43
; __attribute__((nomerge)) ::abort(); } while (false); } } while
(false); do { static_assert( mozilla::detail::AssertionConditionType
<decltype("nsIconChannel" != nullptr)>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!("nsIconChannel" != nullptr))
), 0))) { do { } while (false); MOZ_ReportAssertionFailure("\"nsIconChannel\" != nullptr"
" (" "Must specify a name" ")", "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 43); AnnotateMozCrashReason("MOZ_ASSERT" "(" "\"nsIconChannel\" != nullptr"
") (" "Must specify a name" ")"); do { *((volatile int*)__null
) = 43; __attribute__((nomerge)) ::abort(); } while (false); }
} while (false); if (!mRefCnt.isThreadSafe) _mOwningThread.AssertOwnership
("nsIconChannel" " not thread-safe"); const char* const nametmp
= "nsIconChannel"; nsrefcnt count = --mRefCnt; NS_LogRelease
((this), (count), (nametmp)); if (count == 0) { mRefCnt = 1; delete
(this); return 0; } return count; } nsresult nsIconChannel::
QueryInterface(const nsIID& aIID, void** aInstancePtr) { do
{ if (!(aInstancePtr)) { NS_DebugBreak(NS_DEBUG_ASSERTION, "QueryInterface requires a non-NULL destination!"
, "aInstancePtr", "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 43); MOZ_PretendNoReturn(); } } while (0); nsresult rv = NS_ERROR_FAILURE
; static_assert(2 > 0, "Need more arguments to NS_INTERFACE_TABLE"
); static const QITableEntry table[] = { {&mozilla::detail
::kImplementedIID<nsIconChannel, nsIRequest>, int32_t( reinterpret_cast
<char*>(static_cast<nsIRequest*>((nsIconChannel*)
0x1000)) - reinterpret_cast<char*>((nsIconChannel*)0x1000
))}, {&mozilla::detail::kImplementedIID<nsIconChannel,
nsIChannel>, int32_t( reinterpret_cast<char*>(static_cast
<nsIChannel*>((nsIconChannel*)0x1000)) - reinterpret_cast
<char*>((nsIconChannel*)0x1000))}, {&mozilla::detail
::kImplementedIID<nsIconChannel, nsISupports>, int32_t(
reinterpret_cast<char*>(static_cast<nsISupports*>
( static_cast<nsIRequest*>((nsIconChannel*)0x1000))) - reinterpret_cast
<char*>((nsIconChannel*)0x1000))}, { nullptr, 0 } } ; static_assert
((sizeof(table) / sizeof(table[0])) > 1, "need at least 1 interface"
); rv = NS_TableDrivenQI(static_cast<void*>(this), aIID
, aInstancePtr, table); return rv; }
44
45static nsresult MozGdkPixbufToByteBuf(GdkPixbuf* aPixbuf, ByteBuf* aByteBuf) {
46 int width = gdk_pixbuf_get_width(aPixbuf);
47 int height = gdk_pixbuf_get_height(aPixbuf);
48 NS_ENSURE_TRUE(height < 256 && width < 256 && height > 0 && width > 0 &&do { if ((__builtin_expect(!!(!(height < 256 && width
< 256 && height > 0 && width > 0 &&
gdk_pixbuf_get_colorspace(aPixbuf) == GDK_COLORSPACE_RGB &&
gdk_pixbuf_get_bits_per_sample(aPixbuf) == 8 && gdk_pixbuf_get_has_alpha
(aPixbuf) && gdk_pixbuf_get_n_channels(aPixbuf) == 4)
), 0))) { NS_DebugBreak(NS_DEBUG_WARNING, "NS_ENSURE_TRUE(" "height < 256 && width < 256 && height > 0 && width > 0 && gdk_pixbuf_get_colorspace(aPixbuf) == GDK_COLORSPACE_RGB && gdk_pixbuf_get_bits_per_sample(aPixbuf) == 8 && gdk_pixbuf_get_has_alpha(aPixbuf) && gdk_pixbuf_get_n_channels(aPixbuf) == 4"
") failed", nullptr, "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 53); return NS_ERROR_UNEXPECTED; } } while (false)
49 gdk_pixbuf_get_colorspace(aPixbuf) == GDK_COLORSPACE_RGB &&do { if ((__builtin_expect(!!(!(height < 256 && width
< 256 && height > 0 && width > 0 &&
gdk_pixbuf_get_colorspace(aPixbuf) == GDK_COLORSPACE_RGB &&
gdk_pixbuf_get_bits_per_sample(aPixbuf) == 8 && gdk_pixbuf_get_has_alpha
(aPixbuf) && gdk_pixbuf_get_n_channels(aPixbuf) == 4)
), 0))) { NS_DebugBreak(NS_DEBUG_WARNING, "NS_ENSURE_TRUE(" "height < 256 && width < 256 && height > 0 && width > 0 && gdk_pixbuf_get_colorspace(aPixbuf) == GDK_COLORSPACE_RGB && gdk_pixbuf_get_bits_per_sample(aPixbuf) == 8 && gdk_pixbuf_get_has_alpha(aPixbuf) && gdk_pixbuf_get_n_channels(aPixbuf) == 4"
") failed", nullptr, "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 53); return NS_ERROR_UNEXPECTED; } } while (false)
50 gdk_pixbuf_get_bits_per_sample(aPixbuf) == 8 &&do { if ((__builtin_expect(!!(!(height < 256 && width
< 256 && height > 0 && width > 0 &&
gdk_pixbuf_get_colorspace(aPixbuf) == GDK_COLORSPACE_RGB &&
gdk_pixbuf_get_bits_per_sample(aPixbuf) == 8 && gdk_pixbuf_get_has_alpha
(aPixbuf) && gdk_pixbuf_get_n_channels(aPixbuf) == 4)
), 0))) { NS_DebugBreak(NS_DEBUG_WARNING, "NS_ENSURE_TRUE(" "height < 256 && width < 256 && height > 0 && width > 0 && gdk_pixbuf_get_colorspace(aPixbuf) == GDK_COLORSPACE_RGB && gdk_pixbuf_get_bits_per_sample(aPixbuf) == 8 && gdk_pixbuf_get_has_alpha(aPixbuf) && gdk_pixbuf_get_n_channels(aPixbuf) == 4"
") failed", nullptr, "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 53); return NS_ERROR_UNEXPECTED; } } while (false)
51 gdk_pixbuf_get_has_alpha(aPixbuf) &&do { if ((__builtin_expect(!!(!(height < 256 && width
< 256 && height > 0 && width > 0 &&
gdk_pixbuf_get_colorspace(aPixbuf) == GDK_COLORSPACE_RGB &&
gdk_pixbuf_get_bits_per_sample(aPixbuf) == 8 && gdk_pixbuf_get_has_alpha
(aPixbuf) && gdk_pixbuf_get_n_channels(aPixbuf) == 4)
), 0))) { NS_DebugBreak(NS_DEBUG_WARNING, "NS_ENSURE_TRUE(" "height < 256 && width < 256 && height > 0 && width > 0 && gdk_pixbuf_get_colorspace(aPixbuf) == GDK_COLORSPACE_RGB && gdk_pixbuf_get_bits_per_sample(aPixbuf) == 8 && gdk_pixbuf_get_has_alpha(aPixbuf) && gdk_pixbuf_get_n_channels(aPixbuf) == 4"
") failed", nullptr, "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 53); return NS_ERROR_UNEXPECTED; } } while (false)
52 gdk_pixbuf_get_n_channels(aPixbuf) == 4,do { if ((__builtin_expect(!!(!(height < 256 && width
< 256 && height > 0 && width > 0 &&
gdk_pixbuf_get_colorspace(aPixbuf) == GDK_COLORSPACE_RGB &&
gdk_pixbuf_get_bits_per_sample(aPixbuf) == 8 && gdk_pixbuf_get_has_alpha
(aPixbuf) && gdk_pixbuf_get_n_channels(aPixbuf) == 4)
), 0))) { NS_DebugBreak(NS_DEBUG_WARNING, "NS_ENSURE_TRUE(" "height < 256 && width < 256 && height > 0 && width > 0 && gdk_pixbuf_get_colorspace(aPixbuf) == GDK_COLORSPACE_RGB && gdk_pixbuf_get_bits_per_sample(aPixbuf) == 8 && gdk_pixbuf_get_has_alpha(aPixbuf) && gdk_pixbuf_get_n_channels(aPixbuf) == 4"
") failed", nullptr, "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 53); return NS_ERROR_UNEXPECTED; } } while (false)
53 NS_ERROR_UNEXPECTED)do { if ((__builtin_expect(!!(!(height < 256 && width
< 256 && height > 0 && width > 0 &&
gdk_pixbuf_get_colorspace(aPixbuf) == GDK_COLORSPACE_RGB &&
gdk_pixbuf_get_bits_per_sample(aPixbuf) == 8 && gdk_pixbuf_get_has_alpha
(aPixbuf) && gdk_pixbuf_get_n_channels(aPixbuf) == 4)
), 0))) { NS_DebugBreak(NS_DEBUG_WARNING, "NS_ENSURE_TRUE(" "height < 256 && width < 256 && height > 0 && width > 0 && gdk_pixbuf_get_colorspace(aPixbuf) == GDK_COLORSPACE_RGB && gdk_pixbuf_get_bits_per_sample(aPixbuf) == 8 && gdk_pixbuf_get_has_alpha(aPixbuf) && gdk_pixbuf_get_n_channels(aPixbuf) == 4"
") failed", nullptr, "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 53); return NS_ERROR_UNEXPECTED; } } while (false)
;
54
55 const int n_channels = 4;
56 CheckedInt32 buf_size =
57 4 + n_channels * CheckedInt32(height) * CheckedInt32(width);
58 if (!buf_size.isValid()) {
59 return NS_ERROR_OUT_OF_MEMORY;
60 }
61 uint8_t* const buf = (uint8_t*)moz_xmalloc(buf_size.value());
62 uint8_t* out = buf;
63
64 *(out++) = width;
65 *(out++) = height;
66 *(out++) = uint8_t(mozilla::gfx::SurfaceFormat::OS_RGBA);
67
68 // Set all bits to ensure in nsIconDecoder we color manage and premultiply.
69 *(out++) = 0xFF;
70
71 const guchar* const pixels = gdk_pixbuf_get_pixels(aPixbuf);
72 int instride = gdk_pixbuf_get_rowstride(aPixbuf);
73 int outstride = width * n_channels;
74
75 // encode the RGB data and the A data and adjust the stride as necessary.
76 mozilla::gfx::SwizzleData(pixels, instride,
77 mozilla::gfx::SurfaceFormat::R8G8B8A8, out,
78 outstride, mozilla::gfx::SurfaceFormat::OS_RGBA,
79 mozilla::gfx::IntSize(width, height));
80
81 *aByteBuf = ByteBuf(buf, buf_size.value(), buf_size.value());
82 return NS_OK;
83}
84
85static nsresult ByteBufToStream(ByteBuf&& aBuf, nsIInputStream** aStream) {
86 nsresult rv;
87 nsCOMPtr<nsIStringInputStream> stream =
88 do_CreateInstance("@mozilla.org/io/string-input-stream;1", &rv);
89
90 if (NS_WARN_IF(NS_FAILED(rv))NS_warn_if_impl(((bool)(__builtin_expect(!!(NS_FAILED_impl(rv
)), 0))), "NS_FAILED(rv)", "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 90)
) {
91 return rv;
92 }
93
94 // stream takes ownership of buf and will free it on destruction.
95 // This function cannot fail.
96 rv = stream->AdoptData(reinterpret_cast<char*>(aBuf.mData), aBuf.mLen);
97 MOZ_ASSERT(CheckedInt32(aBuf.mLen).isValid(),do { static_assert( mozilla::detail::AssertionConditionType<
decltype(CheckedInt32(aBuf.mLen).isValid())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(CheckedInt32(aBuf.mLen).isValid
()))), 0))) { do { } while (false); MOZ_ReportAssertionFailure
("CheckedInt32(aBuf.mLen).isValid()" " (" "aBuf.mLen should fit in int32_t"
")", "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 98); AnnotateMozCrashReason("MOZ_ASSERT" "(" "CheckedInt32(aBuf.mLen).isValid()"
") (" "aBuf.mLen should fit in int32_t" ")"); do { *((volatile
int*)__null) = 98; __attribute__((nomerge)) ::abort(); } while
(false); } } while (false)
98 "aBuf.mLen should fit in int32_t")do { static_assert( mozilla::detail::AssertionConditionType<
decltype(CheckedInt32(aBuf.mLen).isValid())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(CheckedInt32(aBuf.mLen).isValid
()))), 0))) { do { } while (false); MOZ_ReportAssertionFailure
("CheckedInt32(aBuf.mLen).isValid()" " (" "aBuf.mLen should fit in int32_t"
")", "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 98); AnnotateMozCrashReason("MOZ_ASSERT" "(" "CheckedInt32(aBuf.mLen).isValid()"
") (" "aBuf.mLen should fit in int32_t" ")"); do { *((volatile
int*)__null) = 98; __attribute__((nomerge)) ::abort(); } while
(false); } } while (false)
;
99 aBuf.mData = nullptr;
100
101 // If this no longer holds then re-examine buf's lifetime.
102 MOZ_ASSERT(NS_SUCCEEDED(rv))do { static_assert( mozilla::detail::AssertionConditionType<
decltype(((bool)(__builtin_expect(!!(!NS_FAILED_impl(rv)), 1)
)))>::isValid, "invalid assertion condition"); if ((__builtin_expect
(!!(!(!!(((bool)(__builtin_expect(!!(!NS_FAILED_impl(rv)), 1)
))))), 0))) { do { } while (false); MOZ_ReportAssertionFailure
("((bool)(__builtin_expect(!!(!NS_FAILED_impl(rv)), 1)))", "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 102); AnnotateMozCrashReason("MOZ_ASSERT" "(" "((bool)(__builtin_expect(!!(!NS_FAILED_impl(rv)), 1)))"
")"); do { *((volatile int*)__null) = 102; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
103 NS_ENSURE_SUCCESS(rv, rv)do { nsresult __rv = rv; if (((bool)(__builtin_expect(!!(NS_FAILED_impl
(__rv)), 0)))) { const char* name = mozilla::GetStaticErrorName
(__rv); mozilla::SmprintfPointer msg = mozilla::Smprintf( "NS_ENSURE_SUCCESS(%s, %s) failed with "
"result 0x%" "X" "%s%s%s", "rv", "rv", static_cast<uint32_t
>(__rv), name ? " (" : "", name ? name : "", name ? ")" : ""
); NS_DebugBreak(NS_DEBUG_WARNING, msg.get(), nullptr, "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 103); return rv; } } while (false)
;
104
105 stream.forget(aStream);
106 return NS_OK;
107}
108
109static nsresult StreamToChannel(already_AddRefed<nsIInputStream> aStream,
110 nsIURI* aURI, nsIChannel** aChannel) {
111 // nsIconProtocolHandler::NewChannel will provide the correct loadInfo for
112 // this iconChannel. Use the most restrictive security settings for the
113 // temporary loadInfo to make sure the channel can not be opened.
114 nsCOMPtr<nsIPrincipal> nullPrincipal =
115 mozilla::NullPrincipal::CreateWithoutOriginAttributes();
116 return NS_NewInputStreamChannel(
117 aChannel, aURI, std::move(aStream), nullPrincipal,
118 nsILoadInfo::SEC_REQUIRE_SAME_ORIGIN_DATA_IS_BLOCKED,
119 nsIContentPolicy::TYPE_INTERNAL_IMAGE, nsLiteralCString(IMAGE_ICON_MS"image/icon"));
120}
121
122static GtkWidget* gProtoWindow = nullptr;
123static GtkWidget* gStockImageWidget = nullptr;
124
125static void ensure_stock_image_widget() {
126 // Only the style of the GtkImage needs to be used, but the widget is kept
127 // to track dynamic style changes.
128 if (!gProtoWindow) {
129 gProtoWindow = gtk_window_new(GTK_WINDOW_POPUP);
130 GtkWidget* protoLayout = gtk_fixed_new();
131 gtk_container_add(GTK_CONTAINER(gProtoWindow)((((GtkContainer*) (void *) ((gProtoWindow))))), protoLayout);
132
133 gStockImageWidget = gtk_image_new();
134 gtk_container_add(GTK_CONTAINER(protoLayout)((((GtkContainer*) (void *) ((protoLayout))))), gStockImageWidget);
135
136 gtk_widget_ensure_style(gStockImageWidget);
137 }
138}
139
140static GtkIconSize moz_gtk_icon_size(const char* name) {
141 if (strcmp(name, "button") == 0) {
142 return GTK_ICON_SIZE_BUTTON;
143 }
144
145 if (strcmp(name, "menu") == 0) {
146 return GTK_ICON_SIZE_MENU;
147 }
148
149 if (strcmp(name, "toolbar") == 0) {
150 return GTK_ICON_SIZE_LARGE_TOOLBAR;
151 }
152
153 if (strcmp(name, "toolbarsmall") == 0) {
154 return GTK_ICON_SIZE_SMALL_TOOLBAR;
155 }
156
157 if (strcmp(name, "dnd") == 0) {
158 return GTK_ICON_SIZE_DND;
159 }
160
161 if (strcmp(name, "dialog") == 0) {
162 return GTK_ICON_SIZE_DIALOG;
163 }
164
165 return GTK_ICON_SIZE_MENU;
166}
167
168static int32_t GetIconSize(nsIMozIconURI* aIconURI) {
169 nsAutoCString iconSizeString;
170
171 aIconURI->GetIconSize(iconSizeString);
172 if (iconSizeString.IsEmpty()) {
173 uint32_t size;
174 mozilla::DebugOnly<nsresult> rv = aIconURI->GetImageSize(&size);
175 NS_ASSERTION(NS_SUCCEEDED(rv), "GetImageSize failed")do { if (!(((bool)(__builtin_expect(!!(!NS_FAILED_impl(rv)), 1
))))) { NS_DebugBreak(NS_DEBUG_ASSERTION, "GetImageSize failed"
, "NS_SUCCEEDED(rv)", "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 175); MOZ_PretendNoReturn(); } } while (0)
;
176 return size;
177 }
178 int size;
179
180 GtkIconSize icon_size = moz_gtk_icon_size(iconSizeString.get());
181 gtk_icon_size_lookup(icon_size, &size, nullptr);
182 return size;
183}
184
185/* Scale icon buffer to preferred size */
186static nsresult ScaleIconBuf(GdkPixbuf** aBuf, int32_t iconSize) {
187 // Scale buffer only if width or height differ from preferred size
188 if (gdk_pixbuf_get_width(*aBuf) != iconSize &&
189 gdk_pixbuf_get_height(*aBuf) != iconSize) {
190 GdkPixbuf* scaled =
191 gdk_pixbuf_scale_simple(*aBuf, iconSize, iconSize, GDK_INTERP_BILINEAR);
192 // replace original buffer by scaled
193 g_object_unref(*aBuf);
194 *aBuf = scaled;
195 if (!scaled) {
196 return NS_ERROR_OUT_OF_MEMORY;
197 }
198 }
199 return NS_OK;
200}
201
202/* static */
203nsresult nsIconChannel::GetIconWithGIO(nsIMozIconURI* aIconURI,
204 ByteBuf* aDataOut) {
205 GIcon* icon = nullptr;
206 nsCOMPtr<nsIURL> fileURI;
207
208 // Read icon content
209 aIconURI->GetIconURL(getter_AddRefs(fileURI));
210
211 // Get icon for file specified by URI
212 if (fileURI) {
213 nsAutoCString spec;
214 fileURI->GetAsciiSpec(spec);
215 if (fileURI->SchemeIs("file")) {
216 GFile* file = g_file_new_for_uri(spec.get());
217 GFileInfo* fileInfo =
218 g_file_query_info(file, G_FILE_ATTRIBUTE_STANDARD_ICON"standard::icon",
219 G_FILE_QUERY_INFO_NONE, nullptr, nullptr);
220 g_object_unref(file);
221 if (fileInfo) {
222 // icon from g_content_type_get_icon doesn't need unref
223 icon = g_file_info_get_icon(fileInfo);
224 if (icon) {
225 g_object_ref(icon);
226 }
227 g_object_unref(fileInfo);
228 }
229 }
230 }
231
232 // Try to get icon by using MIME type
233 if (!icon) {
234 nsAutoCString type;
235 aIconURI->GetContentType(type);
236 // Try to get MIME type from file extension by using nsIMIMEService
237 if (type.IsEmpty()) {
238 nsCOMPtr<nsIMIMEService> ms(do_GetService("@mozilla.org/mime;1"));
239 if (ms) {
240 nsAutoCString fileExt;
241 aIconURI->GetFileExtension(fileExt);
242 ms->GetTypeFromExtension(fileExt, type);
243 }
244 }
245 char* ctype = nullptr; // character representation of content type
246 if (!type.IsEmpty()) {
247 ctype = g_content_type_from_mime_type(type.get());
248 }
249 if (ctype) {
250 icon = g_content_type_get_icon(ctype);
251 g_free(ctype);
252 }
253 }
254
255 // Get default icon theme
256 GtkIconTheme* iconTheme = gtk_icon_theme_get_default();
257 GtkIconInfo* iconInfo = nullptr;
258 // Get icon size
259 int32_t iconSize = GetIconSize(aIconURI);
260
261 if (icon) {
262 // Use icon and theme to get GtkIconInfo
263 iconInfo = gtk_icon_theme_lookup_by_gicon(iconTheme, icon, iconSize,
264 (GtkIconLookupFlags)0);
265 g_object_unref(icon);
266 }
267
268 if (!iconInfo) {
269 // Mozilla's mimetype lookup failed. Try the "unknown" icon.
270 iconInfo = gtk_icon_theme_lookup_icon(iconTheme, "unknown", iconSize,
271 (GtkIconLookupFlags)0);
272 if (!iconInfo) {
273 return NS_ERROR_NOT_AVAILABLE;
274 }
275 }
276
277 // Create a GdkPixbuf buffer containing icon and scale it
278 GdkPixbuf* buf = gtk_icon_info_load_icon(iconInfo, nullptr);
279 gtk_icon_info_free(iconInfo);
280 if (!buf) {
281 return NS_ERROR_UNEXPECTED;
282 }
283
284 nsresult rv = ScaleIconBuf(&buf, iconSize);
285 NS_ENSURE_SUCCESS(rv, rv)do { nsresult __rv = rv; if (((bool)(__builtin_expect(!!(NS_FAILED_impl
(__rv)), 0)))) { const char* name = mozilla::GetStaticErrorName
(__rv); mozilla::SmprintfPointer msg = mozilla::Smprintf( "NS_ENSURE_SUCCESS(%s, %s) failed with "
"result 0x%" "X" "%s%s%s", "rv", "rv", static_cast<uint32_t
>(__rv), name ? " (" : "", name ? name : "", name ? ")" : ""
); NS_DebugBreak(NS_DEBUG_WARNING, msg.get(), nullptr, "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 285); return rv; } } while (false)
;
286
287 rv = MozGdkPixbufToByteBuf(buf, aDataOut);
288 g_object_unref(buf);
289 return rv;
290}
291
292/* static */
293nsresult nsIconChannel::GetIcon(nsIURI* aURI, ByteBuf* aDataOut) {
294 nsCOMPtr<nsIMozIconURI> iconURI = do_QueryInterface(aURI);
295 NS_ASSERTION(iconURI, "URI is not an nsIMozIconURI")do { if (!(iconURI)) { NS_DebugBreak(NS_DEBUG_ASSERTION, "URI is not an nsIMozIconURI"
, "iconURI", "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 295); MOZ_PretendNoReturn(); } } while (0)
;
296
297 if (!iconURI) {
298 return NS_ERROR_NOT_AVAILABLE;
299 }
300
301 if (gfxPlatform::IsHeadless()) {
302 return NS_ERROR_NOT_AVAILABLE;
303 }
304
305 nsAutoCString stockIcon;
306 iconURI->GetStockIcon(stockIcon);
307 if (stockIcon.IsEmpty()) {
308 return GetIconWithGIO(iconURI, aDataOut);
309 }
310
311 // Search for stockIcon
312 nsAutoCString iconSizeString;
313 iconURI->GetIconSize(iconSizeString);
314
315 nsAutoCString iconStateString;
316 iconURI->GetIconState(iconStateString);
317
318 GtkIconSize icon_size = moz_gtk_icon_size(iconSizeString.get());
319 GtkStateType state = iconStateString.EqualsLiteral("disabled")
320 ? GTK_STATE_INSENSITIVE
321 : GTK_STATE_NORMAL;
322
323 // First lookup the icon by stock id and text direction.
324 GtkTextDirection direction = GTK_TEXT_DIR_NONE;
325 if (StringEndsWith(stockIcon, "-ltr"_ns)) {
326 direction = GTK_TEXT_DIR_LTR;
327 } else if (StringEndsWith(stockIcon, "-rtl"_ns)) {
328 direction = GTK_TEXT_DIR_RTL;
329 }
330
331 bool forceDirection = direction != GTK_TEXT_DIR_NONE;
332 nsAutoCString stockID;
333 bool useIconName = false;
334 if (!forceDirection) {
335 direction = gtk_widget_get_default_direction();
336 stockID = stockIcon;
337 } else {
338 // GTK versions < 2.22 use icon names from concatenating stock id with
339 // -(rtl|ltr), which is how the moz-icon stock name is interpreted here.
340 stockID = Substring(stockIcon, 0, stockIcon.Length() - 4);
341 // However, if we lookup bidi icons by the stock name, then GTK versions
342 // >= 2.22 will use a bidi lookup convention that most icon themes do not
343 // yet follow. Therefore, we first check to see if the theme supports the
344 // old icon name as this will have bidi support (if found).
345 GtkIconTheme* icon_theme = gtk_icon_theme_get_default();
346 // Micking what gtk_icon_set_render_icon does with sizes, though it's not
347 // critical as icons will be scaled to suit size. It just means we follow
348 // the same paths and so share caches.
349 gint width, height;
350 if (gtk_icon_size_lookup(icon_size, &width, &height)) {
351 gint size = std::min(width, height);
352 // We use gtk_icon_theme_lookup_icon() without
353 // GTK_ICON_LOOKUP_USE_BUILTIN instead of gtk_icon_theme_has_icon() so
354 // we don't pick up fallback icons added by distributions for backward
355 // compatibility.
356 GtkIconInfo* icon = gtk_icon_theme_lookup_icon(
357 icon_theme, stockIcon.get(), size, (GtkIconLookupFlags)0);
358 if (icon) {
359 useIconName = true;
360 gtk_icon_info_free(icon);
361 }
362 }
363 }
364
365 ensure_stock_image_widget();
366 GtkStyle* style = gtk_widget_get_style(gStockImageWidget);
367 GtkIconSet* icon_set = nullptr;
368 if (!useIconName) {
369 icon_set = gtk_style_lookup_icon_set(style, stockID.get());
370 }
371
372 if (!icon_set) {
373 // Either we have chosen icon-name lookup for a bidi icon, or stockIcon is
374 // not a stock id so we assume it is an icon name.
375 useIconName = true;
376 // Creating a GtkIconSet is a convenient way to allow the style to
377 // render the icon, possibly with variations suitable for insensitive
378 // states.
379 icon_set = gtk_icon_set_new();
380 GtkIconSource* icon_source = gtk_icon_source_new();
381
382 gtk_icon_source_set_icon_name(icon_source, stockIcon.get());
383 gtk_icon_set_add_source(icon_set, icon_source);
384 gtk_icon_source_free(icon_source);
385 }
386
387 GdkPixbuf* icon = gtk_icon_set_render_icon(
388 icon_set, style, direction, state, icon_size, gStockImageWidget, nullptr);
389 if (useIconName) {
390 gtk_icon_set_unref(icon_set);
391 }
392
393 // According to documentation, gtk_icon_set_render_icon() never returns
394 // nullptr, but it does return nullptr when we have the problem reported
395 // here: https://bugzilla.gnome.org/show_bug.cgi?id=629878#c13
396 if (!icon) {
397 return NS_ERROR_NOT_AVAILABLE;
398 }
399
400 nsresult rv = MozGdkPixbufToByteBuf(icon, aDataOut);
401
402 g_object_unref(icon);
403
404 return rv;
405}
406
407nsresult nsIconChannel::Init(nsIURI* aURI) {
408 nsCOMPtr<nsIInputStream> stream;
409
410 using ContentChild = mozilla::dom::ContentChild;
411 if (auto* contentChild = ContentChild::GetSingleton()) {
412 // Get the icon via IPC and translate the promise of a ByteBuf
413 // into an actually-existing channel.
414 RefPtr<ContentChild::GetSystemIconPromise> icon =
415 contentChild->SendGetSystemIcon(aURI);
416 if (!icon) {
417 return NS_ERROR_UNEXPECTED;
418 }
419
420 nsCOMPtr<nsIAsyncInputStream> inputStream;
421 nsCOMPtr<nsIAsyncOutputStream> outputStream;
422 NS_NewPipe2(getter_AddRefs(inputStream), getter_AddRefs(outputStream), true,
423 false, 0, UINT32_MAX(4294967295U));
424
425 // FIXME: Bug 1718324
426 // The GetSystemIcon() call will end up on the parent doing GetIcon()
427 // and by using ByteBuf we might not be immune to some deadlock, at least
428 // on paper. From analysis in
429 // https://phabricator.services.mozilla.com/D118596#3865440 we should be
430 // safe in practice, but it would be nicer to just write that differently.
431
432 icon->Then(
433 mozilla::GetCurrentSerialEventTarget(), __func__,
434 [outputStream](std::tuple<nsresult, mozilla::Maybe<ByteBuf>>&& aArg) {
435 nsresult rv = std::get<0>(aArg);
436 mozilla::Maybe<ByteBuf> bytes = std::move(std::get<1>(aArg));
437
438 if (NS_SUCCEEDED(rv)((bool)(__builtin_expect(!!(!NS_FAILED_impl(rv)), 1)))) {
1
Assuming the condition is true
2
Taking true branch
439 MOZ_RELEASE_ASSERT(bytes)do { static_assert( mozilla::detail::AssertionConditionType<
decltype(bytes)>::isValid, "invalid assertion condition");
if ((__builtin_expect(!!(!(!!(bytes))), 0))) { do { } while (
false); MOZ_ReportAssertionFailure("bytes", "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 439); AnnotateMozCrashReason("MOZ_RELEASE_ASSERT" "(" "bytes"
")"); do { *((volatile int*)__null) = 439; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
3
Taking false branch
4
Loop condition is false. Exiting loop
440 uint32_t written;
441 rv = outputStream->Write(reinterpret_cast<char*>(bytes->mData),
442 static_cast<uint32_t>(bytes->mLen),
443 &written);
444 if (NS_SUCCEEDED(rv)((bool)(__builtin_expect(!!(!NS_FAILED_impl(rv)), 1)))) {
5
Assuming the condition is false
6
Taking false branch
445 const bool wroteAll = static_cast<size_t>(written) == bytes->mLen;
446 MOZ_ASSERT(wroteAll)do { static_assert( mozilla::detail::AssertionConditionType<
decltype(wroteAll)>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(wroteAll))), 0))) { do { } while
(false); MOZ_ReportAssertionFailure("wroteAll", "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 446); AnnotateMozCrashReason("MOZ_ASSERT" "(" "wroteAll" ")"
); do { *((volatile int*)__null) = 446; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
447 if (!wroteAll) {
448 rv = NS_ERROR_UNEXPECTED;
449 }
450 }
451 } else {
452 MOZ_ASSERT(!bytes)do { static_assert( mozilla::detail::AssertionConditionType<
decltype(!bytes)>::isValid, "invalid assertion condition")
; if ((__builtin_expect(!!(!(!!(!bytes))), 0))) { do { } while
(false); MOZ_ReportAssertionFailure("!bytes", "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 452); AnnotateMozCrashReason("MOZ_ASSERT" "(" "!bytes" ")")
; do { *((volatile int*)__null) = 452; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
453 }
454
455 if (NS_FAILED(rv)((bool)(__builtin_expect(!!(NS_FAILED_impl(rv)), 0)))) {
7
Taking true branch
456 outputStream->CloseWithStatus(rv);
457 }
458 },
8
Calling implicit destructor for 'Maybe<mozilla::ipc::ByteBuf>'
9
Calling '~MaybeStorage'
459 [outputStream](mozilla::ipc::ResponseRejectReason) {
460 outputStream->CloseWithStatus(NS_ERROR_FAILURE);
461 });
462
463 stream = inputStream.forget();
464 } else {
465 // Get the icon directly.
466 ByteBuf bytebuf;
467 nsresult rv = GetIcon(aURI, &bytebuf);
468 NS_ENSURE_SUCCESS(rv, rv)do { nsresult __rv = rv; if (((bool)(__builtin_expect(!!(NS_FAILED_impl
(__rv)), 0)))) { const char* name = mozilla::GetStaticErrorName
(__rv); mozilla::SmprintfPointer msg = mozilla::Smprintf( "NS_ENSURE_SUCCESS(%s, %s) failed with "
"result 0x%" "X" "%s%s%s", "rv", "rv", static_cast<uint32_t
>(__rv), name ? " (" : "", name ? name : "", name ? ")" : ""
); NS_DebugBreak(NS_DEBUG_WARNING, msg.get(), nullptr, "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 468); return rv; } } while (false)
;
469
470 rv = ByteBufToStream(std::move(bytebuf), getter_AddRefs(stream));
471 NS_ENSURE_SUCCESS(rv, rv)do { nsresult __rv = rv; if (((bool)(__builtin_expect(!!(NS_FAILED_impl
(__rv)), 0)))) { const char* name = mozilla::GetStaticErrorName
(__rv); mozilla::SmprintfPointer msg = mozilla::Smprintf( "NS_ENSURE_SUCCESS(%s, %s) failed with "
"result 0x%" "X" "%s%s%s", "rv", "rv", static_cast<uint32_t
>(__rv), name ? " (" : "", name ? name : "", name ? ")" : ""
); NS_DebugBreak(NS_DEBUG_WARNING, msg.get(), nullptr, "/var/lib/jenkins/workspace/firefox-scan-build/image/decoders/icon/gtk/nsIconChannel.cpp"
, 471); return rv; } } while (false)
;
472 }
473
474 return StreamToChannel(stream.forget(), aURI, getter_AddRefs(mRealChannel));
475}
476
477void nsIconChannel::Shutdown() {
478 if (gProtoWindow) {
479 gtk_widget_destroy(gProtoWindow);
480 gProtoWindow = nullptr;
481 gStockImageWidget = nullptr;
482 }
483}

/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h

1/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
2/* vim: set ts=8 sts=2 et sw=2 tw=80: */
3/* This Source Code Form is subject to the terms of the Mozilla Public
4 * License, v. 2.0. If a copy of the MPL was not distributed with this
5 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
6
7#ifndef nsINode_h___
8#define nsINode_h___
9
10#include "mozilla/DoublyLinkedList.h"
11#include "mozilla/Likely.h"
12#include "mozilla/UniquePtr.h"
13#include "nsCOMPtr.h" // for member, local
14#include "nsGkAtoms.h" // for nsGkAtoms::baseURIProperty
15#include "mozilla/dom/NodeInfo.h" // member (in nsCOMPtr)
16#include "nsIWeakReference.h"
17#include "nsIMutationObserver.h"
18#include "nsNodeInfoManager.h" // for use in NodePrincipal()
19#include "nsPropertyTable.h" // for typedefs
20#include "mozilla/ErrorResult.h"
21#include "mozilla/LinkedList.h"
22#include "mozilla/MemoryReporting.h"
23#include "mozilla/dom/EventTarget.h" // for base class
24#include "js/TypeDecls.h" // for Handle, Value, JSObject, JSContext
25#include "mozilla/dom/DOMString.h"
26#include "mozilla/dom/BindingDeclarations.h"
27#include "mozilla/dom/NodeBinding.h"
28#include "nsTHashtable.h"
29#include <iosfwd>
30
31// Including 'windows.h' will #define GetClassInfo to something else.
32#ifdef XP_WIN
33# ifdef GetClassInfo
34# undef GetClassInfo
35# endif
36#endif
37
38class AttrArray;
39class nsAttrChildContentList;
40template <typename T>
41class nsCOMArray;
42class nsDOMAttributeMap;
43class nsGenericHTMLElement;
44class nsIAnimationObserver;
45class nsIContent;
46class nsIContentSecurityPolicy;
47class nsIFrame;
48class nsIFormControl;
49class nsIHTMLCollection;
50class nsMultiMutationObserver;
51class nsINode;
52class nsINodeList;
53class nsIPrincipal;
54class nsIURI;
55class nsNodeSupportsWeakRefTearoff;
56class nsDOMMutationObserver;
57class nsRange;
58class nsWindowSizes;
59
60namespace mozilla {
61class EventListenerManager;
62struct StyleSelectorList;
63template <typename T>
64class Maybe;
65class PresShell;
66class TextEditor;
67namespace dom {
68/**
69 * @return true if aChar is what the WHATWG defines as a 'ascii whitespace'.
70 * https://infra.spec.whatwg.org/#ascii-whitespace
71 */
72inline bool IsSpaceCharacter(char16_t aChar) {
73 return aChar == ' ' || aChar == '\t' || aChar == '\n' || aChar == '\r' ||
74 aChar == '\f';
75}
76inline bool IsSpaceCharacter(char aChar) {
77 return aChar == ' ' || aChar == '\t' || aChar == '\n' || aChar == '\r' ||
78 aChar == '\f';
79}
80class AbstractRange;
81class AccessibleNode;
82template <typename T>
83class AncestorsOfTypeIterator;
84struct BoxQuadOptions;
85struct ConvertCoordinateOptions;
86class DocGroup;
87class Document;
88class DocumentFragment;
89class DocumentOrShadowRoot;
90class DOMPoint;
91class DOMQuad;
92class DOMRectReadOnly;
93class Element;
94class EventHandlerNonNull;
95template <typename T>
96class FlatTreeAncestorsOfTypeIterator;
97template <typename T>
98class InclusiveAncestorsOfTypeIterator;
99template <typename T>
100class InclusiveFlatTreeAncestorsOfTypeIterator;
101class LinkStyle;
102class MutationObservers;
103template <typename T>
104class Optional;
105class OwningNodeOrString;
106class SelectionNodeCache;
107template <typename>
108class Sequence;
109class ShadowRoot;
110class SVGUseElement;
111class Text;
112class TextOrElementOrDocument;
113struct DOMPointInit;
114struct GetRootNodeOptions;
115enum class CallerType : uint32_t;
116} // namespace dom
117} // namespace mozilla
118
119#define NODE_FLAG_BIT(n_)(nsWrapperCache::FlagsType(1U) << (WRAPPER_CACHE_FLAGS_BITS_USED
+ (n_)))
\
120 (nsWrapperCache::FlagsType(1U) << (WRAPPER_CACHE_FLAGS_BITS_USED + (n_)))
121
122enum : uint32_t {
123 // This bit will be set if the node has a listener manager.
124 NODE_HAS_LISTENERMANAGER = NODE_FLAG_BIT(0)(nsWrapperCache::FlagsType(1U) << (WRAPPER_CACHE_FLAGS_BITS_USED
+ (0)))
,
125
126 // Whether this node has had any properties set on it
127 NODE_HAS_PROPERTIES = NODE_FLAG_BIT(1)(nsWrapperCache::FlagsType(1U) << (WRAPPER_CACHE_FLAGS_BITS_USED
+ (1)))
,
128
129 // Whether the node has some ancestor, possibly itself, that is native
130 // anonymous. This includes ancestors crossing XBL scopes, in cases when an
131 // XBL binding is attached to an element which has a native anonymous
132 // ancestor. This flag is set-once: once a node has it, it must not be
133 // removed.
134 // NOTE: Should only be used on nsIContent nodes
135 NODE_IS_IN_NATIVE_ANONYMOUS_SUBTREE = NODE_FLAG_BIT(2)(nsWrapperCache::FlagsType(1U) << (WRAPPER_CACHE_FLAGS_BITS_USED
+ (2)))
,
136
137 // Whether this node is the root of a native anonymous (from the perspective
138 // of its parent) subtree. This flag is set-once: once a node has it, it
139 // must not be removed.
140 // NOTE: Should only be used on nsIContent nodes
141 NODE_IS_NATIVE_ANONYMOUS_ROOT = NODE_FLAG_BIT(3)(nsWrapperCache::FlagsType(1U) << (WRAPPER_CACHE_FLAGS_BITS_USED
+ (3)))
,
142
143 NODE_IS_EDITABLE = NODE_FLAG_BIT(4)(nsWrapperCache::FlagsType(1U) << (WRAPPER_CACHE_FLAGS_BITS_USED
+ (4)))
,
144
145 // Whether the node participates in a shadow tree.
146 NODE_IS_IN_SHADOW_TREE = NODE_FLAG_BIT(5)(nsWrapperCache::FlagsType(1U) << (WRAPPER_CACHE_FLAGS_BITS_USED
+ (5)))
,
147
148 // This node needs to go through frame construction to get a frame (or
149 // undisplayed entry).
150 NODE_NEEDS_FRAME = NODE_FLAG_BIT(6)(nsWrapperCache::FlagsType(1U) << (WRAPPER_CACHE_FLAGS_BITS_USED
+ (6)))
,
151
152 // At least one descendant in the flattened tree has NODE_NEEDS_FRAME set.
153 // This should be set on every node on the flattened tree path between the
154 // node(s) with NODE_NEEDS_FRAME and the root content.
155 NODE_DESCENDANTS_NEED_FRAMES = NODE_FLAG_BIT(7)(nsWrapperCache::FlagsType(1U) << (WRAPPER_CACHE_FLAGS_BITS_USED
+ (7)))
,
156
157 // Set if the node has the accesskey attribute set.
158 NODE_HAS_ACCESSKEY = NODE_FLAG_BIT(8)(nsWrapperCache::FlagsType(1U) << (WRAPPER_CACHE_FLAGS_BITS_USED
+ (8)))
,
159
160 NODE_HAS_BEEN_IN_UA_WIDGET = NODE_FLAG_BIT(9)(nsWrapperCache::FlagsType(1U) << (WRAPPER_CACHE_FLAGS_BITS_USED
+ (9)))
,
161
162 // Set if the node has a nonce value and a header delivered CSP.
163 NODE_HAS_NONCE_AND_HEADER_CSP = NODE_FLAG_BIT(10)(nsWrapperCache::FlagsType(1U) << (WRAPPER_CACHE_FLAGS_BITS_USED
+ (10)))
,
164
165 NODE_KEEPS_DOMARENA = NODE_FLAG_BIT(11)(nsWrapperCache::FlagsType(1U) << (WRAPPER_CACHE_FLAGS_BITS_USED
+ (11)))
,
166
167 NODE_MAY_HAVE_ELEMENT_CHILDREN = NODE_FLAG_BIT(12)(nsWrapperCache::FlagsType(1U) << (WRAPPER_CACHE_FLAGS_BITS_USED
+ (12)))
,
168
169 NODE_HAS_SCHEDULED_SELECTION_CHANGE_EVENT = NODE_FLAG_BIT(13)(nsWrapperCache::FlagsType(1U) << (WRAPPER_CACHE_FLAGS_BITS_USED
+ (13)))
,
170
171 // Remaining bits are node type specific.
172 NODE_TYPE_SPECIFIC_BITS_OFFSET = 14
173};
174
175// Flags for selectors that persist to the DOM node.
176enum class NodeSelectorFlags : uint32_t {
177 // Node has an :empty or :-moz-only-whitespace selector
178 HasEmptySelector = 1 << 0,
179
180 /// A child of the node has a selector such that any insertion,
181 /// removal, or appending of children requires restyling the parent, if the
182 /// parent is an element. If the parent is the shadow root, the child's
183 /// siblings are restyled.
184 HasSlowSelector = 1 << 1,
185
186 /// A child of the node has a :first-child, :-moz-first-node,
187 /// :only-child, :last-child or :-moz-last-node selector.
188 HasEdgeChildSelector = 1 << 2,
189
190 /// A child of the node has a selector such that any insertion or
191 /// removal of children requires restyling later siblings of that
192 /// element. Additionally (in this manner it is stronger than
193 /// NODE_HAS_SLOW_SELECTOR), if a child's style changes due to any
194 /// other content tree changes (e.g., the child changes to or from
195 /// matching :empty due to a grandchild insertion or removal), the
196 /// child's later siblings must also be restyled.
197 HasSlowSelectorLaterSiblings = 1 << 3,
198
199 /// HasSlowSelector* was set by the presence of :nth (But not of).
200 HasSlowSelectorNth = 1 << 4,
201
202 /// A child of this node might be matched by :nth-child(.. of <selector>) or
203 /// :nth-last-child(.. of <selector>). If a DOM mutation may have caused the
204 /// selector to either match or no longer match that child, the child's
205 /// siblings are restyled.
206 HasSlowSelectorNthOf = 1 << 5,
207
208 /// All instances of :nth flags.
209 HasSlowSelectorNthAll = HasSlowSelectorNthOf | HasSlowSelectorNth,
210
211 /// Set of selector flags that may trigger a restyle on DOM append, with
212 /// restyle on siblings or a single parent (And perhaps their subtrees).
213 AllSimpleRestyleFlagsForAppend = HasEmptySelector | HasSlowSelector |
214 HasEdgeChildSelector | HasSlowSelectorNthAll,
215
216 /// Set of selector flags that may trigger a restyle as a result of any
217 /// DOM mutation.
218 AllSimpleRestyleFlags =
219 AllSimpleRestyleFlagsForAppend | HasSlowSelectorLaterSiblings,
220
221 // This node was evaluated as an anchor for a relative selector.
222 RelativeSelectorAnchor = 1 << 6,
223
224 // This node was evaluated as an anchor for a relative selector, and that
225 // relative selector was not the subject of the overall selector.
226 RelativeSelectorAnchorNonSubject = 1 << 7,
227
228 // This node's sibling(s) performed a relative selector search to this node.
229 RelativeSelectorSearchDirectionSibling = 1 << 8,
230
231 // This node's ancestor(s) performed a relative selector search to this node.
232 RelativeSelectorSearchDirectionAncestor = 1 << 9,
233
234 // This node's sibling(s) and ancestor(s), and/or this node's ancestor's
235 // sibling(s) performed a relative selector search to this node.
236 RelativeSelectorSearchDirectionAncestorSibling =
237 RelativeSelectorSearchDirectionSibling |
238 RelativeSelectorSearchDirectionAncestor,
239};
240
241MOZ_MAKE_ENUM_CLASS_BITWISE_OPERATORS(NodeSelectorFlags)inline constexpr mozilla::CastableTypedEnumResult<NodeSelectorFlags
> operator |( NodeSelectorFlags a, NodeSelectorFlags b) { typedef
mozilla::CastableTypedEnumResult<NodeSelectorFlags> Result
; typedef mozilla::detail::UnsignedIntegerTypeForEnum<NodeSelectorFlags
>::Type U; return Result(NodeSelectorFlags(U(a) | U(b))); }
inline NodeSelectorFlags& operator |=(NodeSelectorFlags &
a, NodeSelectorFlags b) { return a = a | b; } inline constexpr
mozilla::CastableTypedEnumResult<NodeSelectorFlags> operator
&( NodeSelectorFlags a, NodeSelectorFlags b) { typedef mozilla
::CastableTypedEnumResult<NodeSelectorFlags> Result; typedef
mozilla::detail::UnsignedIntegerTypeForEnum<NodeSelectorFlags
>::Type U; return Result(NodeSelectorFlags(U(a) & U(b)
)); } inline NodeSelectorFlags& operator &=(NodeSelectorFlags
& a, NodeSelectorFlags b) { return a = a & b; } inline
constexpr mozilla::CastableTypedEnumResult<NodeSelectorFlags
> operator ^( NodeSelectorFlags a, NodeSelectorFlags b) { typedef
mozilla::CastableTypedEnumResult<NodeSelectorFlags> Result
; typedef mozilla::detail::UnsignedIntegerTypeForEnum<NodeSelectorFlags
>::Type U; return Result(NodeSelectorFlags(U(a) ^ U(b))); }
inline NodeSelectorFlags& operator ^=(NodeSelectorFlags &
a, NodeSelectorFlags b) { return a = a ^ b; } inline constexpr
mozilla::CastableTypedEnumResult<NodeSelectorFlags> operator
~(NodeSelectorFlags a) { typedef mozilla::CastableTypedEnumResult
<NodeSelectorFlags> Result; typedef mozilla::detail::UnsignedIntegerTypeForEnum
<NodeSelectorFlags>::Type U; return Result(NodeSelectorFlags
(~(U(a)))); }
;
242
243// Make sure we have space for our bits
244#define ASSERT_NODE_FLAGS_SPACE(n)static_assert(WRAPPER_CACHE_FLAGS_BITS_USED + (n) <= sizeof
(nsWrapperCache::FlagsType) * 8, "Not enough space for our bits"
)
\
245 static_assert(WRAPPER_CACHE_FLAGS_BITS_USED + (n) <= \
246 sizeof(nsWrapperCache::FlagsType) * 8, \
247 "Not enough space for our bits")
248ASSERT_NODE_FLAGS_SPACE(NODE_TYPE_SPECIFIC_BITS_OFFSET)static_assert(WRAPPER_CACHE_FLAGS_BITS_USED + (NODE_TYPE_SPECIFIC_BITS_OFFSET
) <= sizeof(nsWrapperCache::FlagsType) * 8, "Not enough space for our bits"
)
;
249
250/**
251 * Class used to detect unexpected mutations. To use the class create an
252 * nsMutationGuard on the stack before unexpected mutations could occur.
253 * You can then at any time call Mutated to check if any unexpected mutations
254 * have occurred.
255 */
256class nsMutationGuard {
257 public:
258 nsMutationGuard() { mStartingGeneration = sGeneration; }
259
260 /**
261 * Returns true if any unexpected mutations have occurred. You can pass in
262 * an 8-bit ignore count to ignore a number of expected mutations.
263 *
264 * We don't need to care about overflow because subtraction of uint64_t's is
265 * finding the difference between two elements of the group Z < 2^64. Once
266 * we know the difference between two elements we only need to check that is
267 * less than the given number of mutations to know less than that many
268 * mutations occured. Assuming constant 1ns mutations it would take 584
269 * years for sGeneration to fully wrap around so we can ignore a guard living
270 * through a full wrap around.
271 */
272 bool Mutated(uint8_t aIgnoreCount) {
273 return (sGeneration - mStartingGeneration) > aIgnoreCount;
274 }
275
276 // This function should be called whenever a mutation that we want to keep
277 // track of happen. For now this is only done when children are added or
278 // removed, but we might do it for attribute changes too in the future.
279 static void DidMutate() { sGeneration++; }
280
281 private:
282 // This is the value sGeneration had when the guard was constructed.
283 uint64_t mStartingGeneration;
284
285 // This value is incremented on every mutation, for the life of the process.
286 static uint64_t sGeneration;
287};
288
289/**
290 * A class that implements nsIWeakReference
291 */
292class nsNodeWeakReference final : public nsIWeakReference {
293 public:
294 explicit nsNodeWeakReference(nsINode* aNode);
295
296 // nsISupports
297 NS_DECL_ISUPPORTSpublic: virtual nsresult QueryInterface(const nsIID& aIID
, void** aInstancePtr) override; virtual MozExternalRefCountType
AddRef(void) override; virtual MozExternalRefCountType Release
(void) override; using HasThreadSafeRefCnt = std::false_type;
protected: nsAutoRefCnt mRefCnt; nsAutoOwningThread _mOwningThread
; public:
298
299 // nsIWeakReference
300 NS_DECL_NSIWEAKREFERENCEvirtual nsresult QueryReferentFromScript(const nsIID & uuid
, void * * result) override; virtual size_t SizeOfOnlyThis(mozilla
::MallocSizeOf aMallocSizeOf) override;
301
302 void NoticeNodeDestruction() { mObject = nullptr; }
303
304 private:
305 ~nsNodeWeakReference();
306};
307
308// This should be used for any nsINode sub-class that has fields of its own
309// that it needs to measure; any sub-class that doesn't use it will inherit
310// AddSizeOfExcludingThis from its super-class. AddSizeOfIncludingThis() need
311// not be defined, it is inherited from nsINode.
312#define NS_DECL_ADDSIZEOFEXCLUDINGTHISvirtual void AddSizeOfExcludingThis(nsWindowSizes& aSizes
, size_t* aNodeSize) const override;
\
313 virtual void AddSizeOfExcludingThis(nsWindowSizes& aSizes, \
314 size_t* aNodeSize) const override;
315
316// IID for the nsINode interface
317// Must be kept in sync with xpcom/rust/xpcom/src/interfaces/nonidl.rs
318#define NS_INODE_IID{ 0x70ba4547, 0x7699, 0x44fc, { 0xb3, 0x20, 0x52, 0xdb, 0xe3,
0xd1, 0xf9, 0x0a } }
\
319 { \
320 0x70ba4547, 0x7699, 0x44fc, { \
321 0xb3, 0x20, 0x52, 0xdb, 0xe3, 0xd1, 0xf9, 0x0a \
322 } \
323 }
324
325/**
326 * An internal interface that abstracts some DOMNode-related parts that both
327 * nsIContent and Document share. An instance of this interface has a list
328 * of nsIContent children and provides access to them.
329 */
330class nsINode : public mozilla::dom::EventTarget {
331#ifdef MOZ_DIAGNOSTIC_ASSERT_ENABLED1
332 void AssertInvariantsOnNodeInfoChange();
333#endif
334 public:
335 using BoxQuadOptions = mozilla::dom::BoxQuadOptions;
336 using ConvertCoordinateOptions = mozilla::dom::ConvertCoordinateOptions;
337 using DocGroup = mozilla::dom::DocGroup;
338 using Document = mozilla::dom::Document;
339 using DOMPoint = mozilla::dom::DOMPoint;
340 using DOMPointInit = mozilla::dom::DOMPointInit;
341 using DOMQuad = mozilla::dom::DOMQuad;
342 using DOMRectReadOnly = mozilla::dom::DOMRectReadOnly;
343 using OwningNodeOrString = mozilla::dom::OwningNodeOrString;
344 using TextOrElementOrDocument = mozilla::dom::TextOrElementOrDocument;
345 using CallerType = mozilla::dom::CallerType;
346 using ErrorResult = mozilla::ErrorResult;
347
348 // XXXbz Maybe we should codegen a class holding these constants and
349 // inherit from it...
350 static const auto ELEMENT_NODE = mozilla::dom::Node_Binding::ELEMENT_NODE;
351 static const auto ATTRIBUTE_NODE = mozilla::dom::Node_Binding::ATTRIBUTE_NODE;
352 static const auto TEXT_NODE = mozilla::dom::Node_Binding::TEXT_NODE;
353 static const auto CDATA_SECTION_NODE =
354 mozilla::dom::Node_Binding::CDATA_SECTION_NODE;
355 static const auto ENTITY_REFERENCE_NODE =
356 mozilla::dom::Node_Binding::ENTITY_REFERENCE_NODE;
357 static const auto ENTITY_NODE = mozilla::dom::Node_Binding::ENTITY_NODE;
358 static const auto PROCESSING_INSTRUCTION_NODE =
359 mozilla::dom::Node_Binding::PROCESSING_INSTRUCTION_NODE;
360 static const auto COMMENT_NODE = mozilla::dom::Node_Binding::COMMENT_NODE;
361 static const auto DOCUMENT_NODE = mozilla::dom::Node_Binding::DOCUMENT_NODE;
362 static const auto DOCUMENT_TYPE_NODE =
363 mozilla::dom::Node_Binding::DOCUMENT_TYPE_NODE;
364 static const auto DOCUMENT_FRAGMENT_NODE =
365 mozilla::dom::Node_Binding::DOCUMENT_FRAGMENT_NODE;
366 static const auto NOTATION_NODE = mozilla::dom::Node_Binding::NOTATION_NODE;
367 static const auto MAX_NODE_TYPE = NOTATION_NODE;
368
369 void* operator new(size_t aSize, nsNodeInfoManager* aManager);
370 void* operator new(size_t aSize) = delete;
371 void operator delete(void* aPtr);
372
373 template <class T>
374 using Sequence = mozilla::dom::Sequence<T>;
375
376 NS_DECLARE_STATIC_IID_ACCESSOR(NS_INODE_IID)template <typename T, typename U> struct COMTypeInfo;
377
378 // The |aNodeSize| outparam on this function is where the actual node size
379 // value is put. It gets added to the appropriate value within |aSizes| by
380 // AddSizeOfNodeTree().
381 //
382 // Among the sub-classes that inherit (directly or indirectly) from nsINode,
383 // measurement of the following members may be added later if DMD finds it is
384 // worthwhile:
385 // - nsGenericHTMLElement: mForm, mFieldSet
386 // - nsGenericHTMLFrameElement: mFrameLoader (bug 672539)
387 // - HTMLBodyElement: mContentStyleRule
388 // - HTMLDataListElement: mOptions
389 // - HTMLFieldSetElement: mElements, mDependentElements, mFirstLegend
390 // - HTMLFormElement: many!
391 // - HTMLFrameSetElement: mRowSpecs, mColSpecs
392 // - HTMLInputElement: mInputData, mFiles, mFileList, mStaticDocfileList
393 // - nsHTMLMapElement: mAreas
394 // - HTMLMediaElement: many!
395 // - nsHTMLOutputElement: mDefaultValue, mTokenList
396 // - nsHTMLRowElement: mCells
397 // - nsHTMLSelectElement: mOptions, mRestoreState
398 // - nsHTMLTableElement: mTBodies, mRows, mTableInheritedAttributes
399 // - nsHTMLTableSectionElement: mRows
400 // - nsHTMLTextAreaElement: mControllers, mState
401 //
402 // The following members don't need to be measured:
403 // - nsIContent: mPrimaryFrame, because it's non-owning and measured elsewhere
404 //
405 virtual void AddSizeOfExcludingThis(nsWindowSizes& aSizes,
406 size_t* aNodeSize) const;
407
408 // SizeOfIncludingThis doesn't need to be overridden by sub-classes because
409 // sub-classes of nsINode are guaranteed to be laid out in memory in such a
410 // way that |this| points to the start of the allocated object, even in
411 // methods of nsINode's sub-classes, so aSizes.mState.mMallocSizeOf(this) is
412 // always safe to call no matter which object it was invoked on.
413 void AddSizeOfIncludingThis(nsWindowSizes& aSizes, size_t* aNodeSize) const;
414
415 friend class nsNodeWeakReference;
416 friend class nsNodeSupportsWeakRefTearoff;
417 friend class AttrArray;
418
419#ifdef MOZILLA_INTERNAL_API1
420 explicit nsINode(already_AddRefed<mozilla::dom::NodeInfo>&& aNodeInfo);
421#endif
422
423 virtual ~nsINode();
424
425 bool IsContainerNode() const {
426 return IsElement() || IsDocument() || IsDocumentFragment();
427 }
428
429 /**
430 * Returns true if the node is a HTMLTemplate element.
431 */
432 bool IsTemplateElement() const { return IsHTMLElement(nsGkAtoms::_template); }
433
434 bool IsSlotable() const { return IsElement() || IsText(); }
435
436 /**
437 * Returns true if this is a document node.
438 */
439 bool IsDocument() const {
440 // One less pointer-chase than checking NodeType().
441 return !GetParentNode() && IsInUncomposedDoc();
442 }
443
444 /**
445 * Return this node as a document. Asserts IsDocument().
446 *
447 * This is defined inline in Document.h.
448 */
449 inline Document* AsDocument();
450 inline const Document* AsDocument() const;
451
452 /**
453 * Returns true if this is a document fragment node.
454 */
455 bool IsDocumentFragment() const {
456 return NodeType() == DOCUMENT_FRAGMENT_NODE;
457 }
458
459 virtual bool IsHTMLFormControlElement() const { return false; }
460
461 /**
462 * https://dom.spec.whatwg.org/#concept-tree-inclusive-descendant
463 *
464 * @param aNode must not be nullptr.
465 */
466 bool IsInclusiveDescendantOf(const nsINode* aNode) const;
467
468 /**
469 * https://dom.spec.whatwg.org/#concept-shadow-including-inclusive-descendant
470 *
471 * @param aNode must not be nullptr.
472 */
473 bool IsShadowIncludingInclusiveDescendantOf(const nsINode* aNode) const;
474
475 /**
476 * Returns true if the given node is this node or one of its descendants
477 * in the "flat tree."
478 *
479 * @param aNode must not be nullptr.
480 */
481 bool IsInclusiveFlatTreeDescendantOf(const nsINode* aNode) const;
482
483 /**
484 * Return this node as a document fragment. Asserts IsDocumentFragment().
485 *
486 * This is defined inline in DocumentFragment.h.
487 */
488 inline mozilla::dom::DocumentFragment* AsDocumentFragment();
489 inline const mozilla::dom::DocumentFragment* AsDocumentFragment() const;
490
491 JSObject* WrapObject(JSContext*, JS::Handle<JSObject*> aGivenProto) final;
492
493 /**
494 * Hook for constructing JS::ubi::Concrete specializations for memory
495 * reporting. Specializations are defined in NodeUbiReporting.h.
496 */
497 virtual void ConstructUbiNode(void* storage) = 0;
498
499 /**
500 * returns true if we are in priviliged code or
501 * layout.css.getBoxQuads.enabled == true.
502 */
503 static bool HasBoxQuadsSupport(JSContext* aCx, JSObject* /* unused */);
504
505 protected:
506 /**
507 * WrapNode is called from WrapObject to actually wrap this node, WrapObject
508 * does some additional checks and fix-up that's common to all nodes. WrapNode
509 * should just call the DOM binding's Wrap function.
510 *
511 * aGivenProto is the prototype to use (or null if the default one should be
512 * used) and should just be passed directly on to the DOM binding's Wrap
513 * function.
514 */
515 virtual JSObject* WrapNode(JSContext* aCx,
516 JS::Handle<JSObject*> aGivenProto) = 0;
517
518 public:
519 mozilla::dom::ParentObject GetParentObject()
520 const; // Implemented in Document.h
521
522 /**
523 * Returns the first child of a node or the first child of
524 * a template element's content if the provided node is a
525 * template element.
526 */
527 nsIContent* GetFirstChildOfTemplateOrNode();
528
529 /**
530 * Return the scope chain parent for this node, for use in things
531 * like event handler compilation. Returning null means to use the
532 * global object as the scope chain parent.
533 */
534 virtual nsINode* GetScopeChainParent() const;
535
536 MOZ_CAN_RUN_SCRIPT mozilla::dom::Element* GetParentFlexElement();
537
538 /**
539 * Returns the nearest inclusive open popover for a given node, see
540 * https://html.spec.whatwg.org/multipage/popover.html#nearest-inclusive-open-popover
541 */
542 mozilla::dom::Element* GetNearestInclusiveOpenPopover() const;
543
544 /**
545 * https://html.spec.whatwg.org/multipage/popover.html#nearest-inclusive-target-popover-for-invoker
546 */
547 mozilla::dom::Element* GetNearestInclusiveTargetPopoverForInvoker() const;
548
549 nsGenericHTMLElement* GetEffectiveInvokeTargetElement() const;
550
551 /**
552 * https://html.spec.whatwg.org/multipage/popover.html#popover-target-element
553 */
554 nsGenericHTMLElement* GetEffectivePopoverTargetElement() const;
555
556 /**
557 * https://html.spec.whatwg.org/multipage/popover.html#topmost-clicked-popover
558 */
559 mozilla::dom::Element* GetTopmostClickedPopover() const;
560
561 bool IsNode() const final { return true; }
562
563 NS_IMPL_FROMEVENTTARGET_HELPER(nsINode, IsNode())template <typename T> static auto FromEventTarget( T&
aEventTarget) -> decltype(static_cast< nsINode*>(&
aEventTarget)) { return aEventTarget.IsNode() ? static_cast<
nsINode*>(&aEventTarget) : nullptr; } template <typename
T> static nsINode* FromEventTarget( T* aEventTarget) { do
{ static_assert( mozilla::detail::AssertionConditionType<
decltype(aEventTarget)>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(aEventTarget))), 0))) { do {
} while (false); MOZ_ReportAssertionFailure("aEventTarget", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 563); AnnotateMozCrashReason("MOZ_DIAGNOSTIC_ASSERT" "(" "aEventTarget"
")"); do { *((volatile int*)__null) = 563; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false); return FromEventTarget
(*aEventTarget); } template <typename T> static nsINode
* FromEventTargetOrNull( T* aEventTarget) { return aEventTarget
? FromEventTarget(*aEventTarget) : nullptr; } template <typename
T> static auto FromEventTarget(const T& aEventTarget)
-> decltype(static_cast<const nsINode*>(&aEventTarget
)) { return aEventTarget.IsNode() ? static_cast<const nsINode
*>(&aEventTarget) : nullptr; } template <typename T
> static const nsINode* FromEventTarget(const T* aEventTarget
) { do { static_assert( mozilla::detail::AssertionConditionType
<decltype(aEventTarget)>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(aEventTarget))), 0))) { do {
} while (false); MOZ_ReportAssertionFailure("aEventTarget", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 563); AnnotateMozCrashReason("MOZ_DIAGNOSTIC_ASSERT" "(" "aEventTarget"
")"); do { *((volatile int*)__null) = 563; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false); return FromEventTarget
(*aEventTarget); } template <typename T> static const nsINode
* FromEventTargetOrNull(const T* aEventTarget) { return aEventTarget
? FromEventTarget(*aEventTarget) : nullptr; } template <typename
T> static nsINode* FromEventTarget(T&& aEventTarget
) { do { static_assert( mozilla::detail::AssertionConditionType
<decltype(!!aEventTarget)>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(!!aEventTarget))), 0))) { do
{ } while (false); MOZ_ReportAssertionFailure("!!aEventTarget"
, "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 563); AnnotateMozCrashReason("MOZ_DIAGNOSTIC_ASSERT" "(" "!!aEventTarget"
")"); do { *((volatile int*)__null) = 563; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false); return aEventTarget
->IsNode() ? static_cast<nsINode*>(static_cast<EventTarget
*>(aEventTarget)) : nullptr; } template <typename T>
static nsINode* FromEventTargetOrNull(T&& aEventTarget
) { return aEventTarget ? FromEventTarget(aEventTarget) : nullptr
; }
564
565 /**
566 * Return whether the node is an Element node. Faster than using `NodeType()`.
567 */
568 bool IsElement() const { return GetBoolFlag(NodeIsElement); }
569
570 virtual bool IsTextControlElement() const { return false; }
571 virtual bool IsGenericHTMLFormControlElementWithState() const {
572 return false;
573 }
574
575 // Returns non-null if this element subclasses `LinkStyle`.
576 virtual const mozilla::dom::LinkStyle* AsLinkStyle() const { return nullptr; }
577 mozilla::dom::LinkStyle* AsLinkStyle() {
578 return const_cast<mozilla::dom::LinkStyle*>(
579 static_cast<const nsINode*>(this)->AsLinkStyle());
580 }
581
582 /**
583 * Return this node as an Element. Should only be used for nodes
584 * for which IsElement() is true. This is defined inline in Element.h.
585 */
586 inline mozilla::dom::Element* AsElement();
587 inline const mozilla::dom::Element* AsElement() const;
588
589 /**
590 * Return whether the node is an nsStyledElement instance or not.
591 */
592 virtual bool IsStyledElement() const { return false; }
593
594 /**
595 * Return this node as nsIContent. Should only be used for nodes for which
596 * IsContent() is true.
597 *
598 * The assertion in nsIContent's constructor makes this safe.
599 */
600 nsIContent* AsContent() {
601 MOZ_ASSERT(IsContent())do { static_assert( mozilla::detail::AssertionConditionType<
decltype(IsContent())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(IsContent()))), 0))) { do { }
while (false); MOZ_ReportAssertionFailure("IsContent()", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 601); AnnotateMozCrashReason("MOZ_ASSERT" "(" "IsContent()"
")"); do { *((volatile int*)__null) = 601; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
602 return reinterpret_cast<nsIContent*>(this);
603 }
604 const nsIContent* AsContent() const {
605 MOZ_ASSERT(IsContent())do { static_assert( mozilla::detail::AssertionConditionType<
decltype(IsContent())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(IsContent()))), 0))) { do { }
while (false); MOZ_ReportAssertionFailure("IsContent()", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 605); AnnotateMozCrashReason("MOZ_ASSERT" "(" "IsContent()"
")"); do { *((volatile int*)__null) = 605; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
606 return reinterpret_cast<const nsIContent*>(this);
607 }
608
609 /*
610 * Return whether the node is a Text node (which might be an actual
611 * textnode, or might be a CDATA section).
612 */
613 bool IsText() const {
614 uint32_t nodeType = NodeType();
615 return nodeType == TEXT_NODE || nodeType == CDATA_SECTION_NODE;
616 }
617
618 /**
619 * Return this node as Text if it is one, otherwise null. This is defined
620 * inline in Text.h.
621 */
622 inline mozilla::dom::Text* GetAsText();
623 inline const mozilla::dom::Text* GetAsText() const;
624
625 /**
626 * Return this node as Text. Asserts IsText(). This is defined inline in
627 * Text.h.
628 */
629 inline mozilla::dom::Text* AsText();
630 inline const mozilla::dom::Text* AsText() const;
631
632 /**
633 * Return this node if the instance type inherits nsIFormControl, or an
634 * nsIFormControl instance which ia associated with this node. Otherwise,
635 * returns nullptr.
636 */
637 [[nodiscard]] virtual nsIFormControl* GetAsFormControl() { return nullptr; }
638 [[nodiscard]] virtual const nsIFormControl* GetAsFormControl() const {
639 return nullptr;
640 }
641
642 /*
643 * Return whether the node is a ProcessingInstruction node.
644 */
645 bool IsProcessingInstruction() const {
646 return NodeType() == PROCESSING_INSTRUCTION_NODE;
647 }
648
649 /*
650 * Return whether the node is a CharacterData node (text, cdata,
651 * comment, processing instruction)
652 */
653 bool IsCharacterData() const {
654 uint32_t nodeType = NodeType();
655 return nodeType == TEXT_NODE || nodeType == CDATA_SECTION_NODE ||
656 nodeType == PROCESSING_INSTRUCTION_NODE || nodeType == COMMENT_NODE;
657 }
658
659 /**
660 * Return whether the node is a Comment node.
661 */
662 bool IsComment() const { return NodeType() == COMMENT_NODE; }
663
664 /**
665 * Return whether the node is an Attr node.
666 */
667 bool IsAttr() const { return NodeType() == ATTRIBUTE_NODE; }
668
669 /**
670 * Return if this node has any children.
671 */
672 bool HasChildren() const { return !!mFirstChild; }
673
674 /**
675 * Get the number of children
676 * @return the number of children
677 */
678 uint32_t GetChildCount() const { return mChildCount; }
679
680 /**
681 * NOTE: this function is going to be removed soon (hopefully!) Don't use it
682 * in new code.
683 *
684 * Get a child by index
685 * @param aIndex the index of the child to get
686 * @return the child, or null if index out of bounds
687 */
688 nsIContent* GetChildAt_Deprecated(uint32_t aIndex) const;
689
690 /**
691 * Get the index of a child within this content.
692 *
693 * @param aPossibleChild the child to get the index of.
694 * @return the index of the child, or Nothing if not a child. Be aware that
695 * anonymous children (e.g. a <div> child of an <input> element) will
696 * result in Nothing.
697 *
698 * If the return value is Some, then calling GetChildAt_Deprecated() with
699 * that value will return aPossibleChild.
700 */
701 mozilla::Maybe<uint32_t> ComputeIndexOf(const nsINode* aPossibleChild) const;
702
703 /**
704 * Get the index of a child within this content's flat tree children.
705 *
706 * @param aPossibleChild the child to get the index of.
707 * @return the index of the child, or Nothing if not a child. Be aware that
708 * anonymous children (e.g. a <div> child of an <input> element) will
709 * result in Nothing.
710 */
711 mozilla::Maybe<uint32_t> ComputeFlatTreeIndexOf(
712 const nsINode* aPossibleChild) const;
713
714 /**
715 * Get the index of this within parent node (ComputeIndexInParentNode) or
716 * parent content (nsIContent) node (ComputeIndexInParentContent).
717 *
718 * @return the index of this node in the parent, or Nothing there is no
719 * parent (content) node or the parent does not have this node anymore
720 * (e.g., being removed from the parent). Be aware that anonymous
721 * children (e.g. a <div> child of an <input> element) will result in
722 * Nothing.
723 *
724 * If the return value is Some, then calling GetChildAt_Deprecated() with
725 * that value will return this.
726 */
727 mozilla::Maybe<uint32_t> ComputeIndexInParentNode() const;
728 mozilla::Maybe<uint32_t> ComputeIndexInParentContent() const;
729
730 /**
731 * Get the index of a child within this content.
732 *
733 * @param aPossibleChild the child to get the index of.
734 * @return the index of the child, or -1 if not a child. Be aware that
735 * anonymous children (e.g. a <div> child of an <input> element) will
736 * result in -1.
737 *
738 * If the return value is not -1, then calling GetChildAt_Deprecated() with
739 * that value will return aPossibleChild.
740 */
741 int32_t ComputeIndexOf_Deprecated(const nsINode* aPossibleChild) const;
742
743 /**
744 * Returns the "node document" of this node.
745 *
746 * https://dom.spec.whatwg.org/#concept-node-document
747 *
748 * Note that in the case that this node is a document node this method
749 * will return |this|. That is different to the Node.ownerDocument DOM
750 * attribute (implemented by nsINode::GetOwnerDocument) which is specified to
751 * be null in that case:
752 *
753 * https://dom.spec.whatwg.org/#dom-node-ownerdocument
754 *
755 * For all other cases OwnerDoc and GetOwnerDocument behave identically.
756 */
757 Document* OwnerDoc() const MOZ_NONNULL_RETURN__attribute__((returns_nonnull)) {
758 return mNodeInfo->GetDocument();
759 }
760
761 /**
762 * Return the "owner document" of this node as an nsINode*. Implemented
763 * in Document.h.
764 */
765 inline nsINode* OwnerDocAsNode() const MOZ_NONNULL_RETURN__attribute__((returns_nonnull));
766
767 /**
768 * Returns true if the content has an ancestor that is a document.
769 *
770 * @return whether this content is in a document tree
771 */
772 bool IsInUncomposedDoc() const { return GetBoolFlag(IsInDocument); }
773
774 /**
775 * Get the document that this content is currently in, if any. This will be
776 * null if the content has no ancestor that is a document.
777 *
778 * @return the current document
779 */
780
781 Document* GetUncomposedDoc() const {
782 return IsInUncomposedDoc() ? OwnerDoc() : nullptr;
783 }
784
785 /**
786 * Returns true if we're connected, and thus GetComposedDoc() would return a
787 * non-null value.
788 */
789 bool IsInComposedDoc() const { return GetBoolFlag(IsConnected); }
790
791 /**
792 * This method returns the owner document if the node is connected to it
793 * (as defined in the DOM spec), otherwise it returns null.
794 * In other words, returns non-null even in the case the node is in
795 * Shadow DOM, if there is a possibly shadow boundary crossing path from
796 * the node to its owner document.
797 */
798 Document* GetComposedDoc() const {
799 return IsInComposedDoc() ? OwnerDoc() : nullptr;
800 }
801
802 /**
803 * Returns OwnerDoc() if the node is in uncomposed document and ShadowRoot if
804 * the node is in Shadow DOM.
805 */
806 mozilla::dom::DocumentOrShadowRoot* GetContainingDocumentOrShadowRoot() const;
807
808 /**
809 * Returns OwnerDoc() if the node is in uncomposed document and ShadowRoot if
810 * the node is in Shadow DOM and is in composed document.
811 */
812 mozilla::dom::DocumentOrShadowRoot* GetUncomposedDocOrConnectedShadowRoot()
813 const;
814
815 /**
816 * To be called when reference count of the node drops to zero.
817 */
818 void LastRelease();
819
820 /**
821 * The values returned by this function are the ones defined for
822 * Node.nodeType
823 */
824 uint16_t NodeType() const { return mNodeInfo->NodeType(); }
825 const nsString& NodeName() const { return mNodeInfo->NodeName(); }
826 const nsString& LocalName() const { return mNodeInfo->LocalName(); }
827
828 /**
829 * Get the NodeInfo for this element
830 * @return the nodes node info
831 */
832 inline mozilla::dom::NodeInfo* NodeInfo() const { return mNodeInfo; }
833
834 /**
835 * Called when we have been adopted, and the information of the
836 * node has been changed.
837 *
838 * The new document can be reached via OwnerDoc().
839 *
840 * If you override this method,
841 * please call up to the parent NodeInfoChanged.
842 *
843 * If you change this, change also the similar method in Link.
844 */
845 virtual void NodeInfoChanged(Document* aOldDoc) {
846#ifdef MOZ_DIAGNOSTIC_ASSERT_ENABLED1
847 AssertInvariantsOnNodeInfoChange();
848#endif
849 }
850
851 inline bool IsInNamespace(int32_t aNamespace) const {
852 return mNodeInfo->NamespaceID() == aNamespace;
853 }
854
855 /**
856 * Returns the DocGroup of the "node document" of this node.
857 */
858 DocGroup* GetDocGroup() const;
859
860 /**
861 * Print a debugger friendly descriptor of this element. This will describe
862 * the position of this element in the document.
863 */
864 friend std::ostream& operator<<(std::ostream& aStream, const nsINode& aNode);
865
866 protected:
867 // These 2 methods are useful for the recursive templates IsHTMLElement,
868 // IsSVGElement, etc.
869 inline bool IsNodeInternal() const { return false; }
870
871 template <typename First, typename... Args>
872 inline bool IsNodeInternal(First aFirst, Args... aArgs) const {
873 return mNodeInfo->Equals(aFirst) || IsNodeInternal(aArgs...);
874 }
875
876 public:
877 inline bool IsHTMLElement() const {
878 return IsElement() && IsInNamespace(kNameSpaceID_XHTML3);
879 }
880
881 inline bool IsHTMLElement(const nsAtom* aTag) const {
882 return IsElement() && mNodeInfo->Equals(aTag, kNameSpaceID_XHTML3);
883 }
884
885 template <typename First, typename... Args>
886 inline bool IsAnyOfHTMLElements(First aFirst, Args... aArgs) const {
887 return IsHTMLElement() && IsNodeInternal(aFirst, aArgs...);
888 }
889
890 inline bool IsSVGElement() const {
891 return IsElement() && IsInNamespace(kNameSpaceID_SVG9);
892 }
893
894 inline bool IsSVGElement(const nsAtom* aTag) const {
895 return IsElement() && mNodeInfo->Equals(aTag, kNameSpaceID_SVG9);
896 }
897
898 template <typename First, typename... Args>
899 inline bool IsAnyOfSVGElements(First aFirst, Args... aArgs) const {
900 return IsSVGElement() && IsNodeInternal(aFirst, aArgs...);
901 }
902
903 virtual bool IsSVGAnimationElement() const { return false; }
904 virtual bool IsSVGComponentTransferFunctionElement() const { return false; }
905 virtual bool IsSVGFilterPrimitiveElement() const { return false; }
906 virtual bool IsSVGFilterPrimitiveChildElement() const { return false; }
907 virtual bool IsSVGGeometryElement() const { return false; }
908 virtual bool IsSVGGraphicsElement() const { return false; }
909
910 inline bool IsXULElement() const {
911 return IsElement() && IsInNamespace(kNameSpaceID_XUL8);
912 }
913
914 inline bool IsXULElement(const nsAtom* aTag) const {
915 return IsElement() && mNodeInfo->Equals(aTag, kNameSpaceID_XUL8);
916 }
917
918 template <typename First, typename... Args>
919 inline bool IsAnyOfXULElements(First aFirst, Args... aArgs) const {
920 return IsXULElement() && IsNodeInternal(aFirst, aArgs...);
921 }
922
923 inline bool IsMathMLElement() const {
924 return IsElement() && IsInNamespace(kNameSpaceID_MathML6);
925 }
926
927 inline bool IsMathMLElement(const nsAtom* aTag) const {
928 return IsElement() && mNodeInfo->Equals(aTag, kNameSpaceID_MathML6);
929 }
930
931 template <typename First, typename... Args>
932 inline bool IsAnyOfMathMLElements(First aFirst, Args... aArgs) const {
933 return IsMathMLElement() && IsNodeInternal(aFirst, aArgs...);
934 }
935
936 bool IsShadowRoot() const {
937 const bool isShadowRoot = IsInShadowTree() && !GetParentNode();
938 MOZ_ASSERT_IF(isShadowRoot, IsDocumentFragment())do { if (isShadowRoot) { do { static_assert( mozilla::detail::
AssertionConditionType<decltype(IsDocumentFragment())>::
isValid, "invalid assertion condition"); if ((__builtin_expect
(!!(!(!!(IsDocumentFragment()))), 0))) { do { } while (false)
; MOZ_ReportAssertionFailure("IsDocumentFragment()", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 938); AnnotateMozCrashReason("MOZ_ASSERT" "(" "IsDocumentFragment()"
")"); do { *((volatile int*)__null) = 938; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false); } } while (
false)
;
939 return isShadowRoot;
940 }
941
942 bool IsHTMLHeadingElement() const {
943 return IsAnyOfHTMLElements(nsGkAtoms::h1, nsGkAtoms::h2, nsGkAtoms::h3,
944 nsGkAtoms::h4, nsGkAtoms::h5, nsGkAtoms::h6);
945 }
946
947 /**
948 * Check whether the conditional processing attributes other than
949 * systemLanguage "return true" if they apply to and are specified
950 * on the given SVG element. Returns true if this element should be
951 * rendered, false if it should not.
952 */
953 virtual bool PassesConditionalProcessingTests() const { return true; }
954
955 /**
956 * Insert a content node before another or at the end.
957 * This method handles calling BindToTree on the child appropriately.
958 *
959 * @param aKid the content to insert
960 * @param aBeforeThis an existing node. Use nullptr if you want to
961 * add aKid at the end.
962 * @param aNotify whether to notify the document (current document for
963 * nsIContent, and |this| for Document) that the insert has occurred
964 * @param aRv The error, if any.
965 * Throw NS_ERROR_DOM_HIERARCHY_REQUEST_ERR if one attempts to have
966 * more than one element node as a child of a document. Doing this
967 * will also assert -- you shouldn't be doing it! Check with
968 * Document::GetRootElement() first if you're not sure. Apart from
969 * this one constraint, this doesn't do any checking on whether aKid is
970 * a valid child of |this|.
971 * Throw NS_ERROR_OUT_OF_MEMORY in some cases (from BindToTree).
972 */
973 virtual void InsertChildBefore(nsIContent* aKid, nsIContent* aBeforeThis,
974 bool aNotify, mozilla::ErrorResult& aRv);
975
976 /**
977 * Append a content node to the end of the child list. This method handles
978 * calling BindToTree on the child appropriately.
979 *
980 * @param aKid the content to append
981 * @param aNotify whether to notify the document (current document for
982 * nsIContent, and |this| for Document) that the append has occurred
983 * @param aRv The error, if any.
984 * Throw NS_ERROR_DOM_HIERARCHY_REQUEST_ERR if one attempts to have
985 * more than one element node as a child of a document. Doing this
986 * will also assert -- you shouldn't be doing it! Check with
987 * Document::GetRootElement() first if you're not sure. Apart from
988 * this one constraint, this doesn't do any checking on whether aKid is
989 * a valid child of |this|.
990 * Throw NS_ERROR_OUT_OF_MEMORY in some cases (from BindToTree).
991 */
992 void AppendChildTo(nsIContent* aKid, bool aNotify,
993 mozilla::ErrorResult& aRv) {
994 InsertChildBefore(aKid, nullptr, aNotify, aRv);
995 }
996
997 /**
998 * Remove a child from this node. This method handles calling UnbindFromTree
999 * on the child appropriately.
1000 *
1001 * @param aKid the content to remove
1002 * @param aNotify whether to notify the document (current document for
1003 * nsIContent, and |this| for Document) that the remove has occurred
1004 */
1005 virtual void RemoveChildNode(nsIContent* aKid, bool aNotify);
1006
1007 /**
1008 * Get a property associated with this node.
1009 *
1010 * @param aPropertyName name of property to get.
1011 * @param aStatus out parameter for storing resulting status.
1012 * Set to NS_PROPTABLE_PROP_NOT_THERE if the property
1013 * is not set.
1014 * @return the property. Null if the property is not set
1015 * (though a null return value does not imply the
1016 * property was not set, i.e. it can be set to null).
1017 */
1018 void* GetProperty(const nsAtom* aPropertyName,
1019 nsresult* aStatus = nullptr) const;
1020
1021 /**
1022 * Set a property to be associated with this node. This will overwrite an
1023 * existing value if one exists. The existing value is destroyed using the
1024 * destructor function given when that value was set.
1025 *
1026 * @param aPropertyName name of property to set.
1027 * @param aValue new value of property.
1028 * @param aDtor destructor function to be used when this property
1029 * is destroyed.
1030 * @param aTransfer if true the property will not be deleted when the
1031 * ownerDocument of the node changes, if false it
1032 * will be deleted.
1033 *
1034 * @return NS_PROPTABLE_PROP_OVERWRITTEN (success value) if the property
1035 * was already set
1036 * @throws NS_ERROR_OUT_OF_MEMORY if that occurs
1037 */
1038 nsresult SetProperty(nsAtom* aPropertyName, void* aValue,
1039 NSPropertyDtorFunc aDtor = nullptr,
1040 bool aTransfer = false);
1041
1042 /**
1043 * A generic destructor for property values allocated with new.
1044 */
1045 template <class T>
1046 static void DeleteProperty(void*, nsAtom*, void* aPropertyValue, void*) {
1047 delete static_cast<T*>(aPropertyValue);
1048 }
1049
1050 /**
1051 * Removes a property associated with this node. The value is destroyed using
1052 * the destruction function given when that value was set.
1053 *
1054 * @param aPropertyName name of property to destroy.
1055 */
1056 void RemoveProperty(const nsAtom* aPropertyName);
1057
1058 /**
1059 * Take a property associated with this node. The value will not be destroyed
1060 * but rather returned. It is the caller's responsibility to destroy the value
1061 * after that point.
1062 *
1063 * @param aPropertyName name of property to unset.
1064 * @param aStatus out parameter for storing resulting status.
1065 * Set to NS_PROPTABLE_PROP_NOT_THERE if the property
1066 * is not set.
1067 * @return the property. Null if the property is not set
1068 * (though a null return value does not imply the
1069 * property was not set, i.e. it can be set to null).
1070 */
1071 void* TakeProperty(const nsAtom* aPropertyName, nsresult* aStatus = nullptr);
1072
1073 bool HasProperties() const { return HasFlag(NODE_HAS_PROPERTIES); }
1074
1075 /**
1076 * Return the principal of this node. This is guaranteed to never be a null
1077 * pointer.
1078 */
1079 nsIPrincipal* NodePrincipal() const {
1080 return mNodeInfo->NodeInfoManager()->DocumentPrincipal();
1081 }
1082
1083 /**
1084 * Return the CSP of this node's document, if any.
1085 */
1086 nsIContentSecurityPolicy* GetCsp() const;
1087
1088 /**
1089 * Get the parent nsIContent for this node.
1090 * @return the parent, or null if no parent or the parent is not an nsIContent
1091 */
1092 nsIContent* GetParent() const {
1093 return MOZ_LIKELY(GetBoolFlag(ParentIsContent))(__builtin_expect(!!(GetBoolFlag(ParentIsContent)), 1)) ? mParent->AsContent()
1094 : nullptr;
1095 }
1096
1097 /**
1098 * Get the parent nsINode for this node. This can be either an nsIContent, a
1099 * Document or an Attr.
1100 * @return the parent node
1101 */
1102 nsINode* GetParentNode() const { return mParent; }
1103
1104 private:
1105 nsIContent* DoGetShadowHost() const;
1106
1107 public:
1108 nsINode* GetParentOrShadowHostNode() const {
1109 if (MOZ_LIKELY(mParent)(__builtin_expect(!!(mParent), 1))) {
1110 return mParent;
1111 }
1112 // We could put this in nsIContentInlines.h or such to avoid this
1113 // reinterpret_cast, but it doesn't seem worth it.
1114 return IsInShadowTree() ? reinterpret_cast<nsINode*>(DoGetShadowHost())
1115 : nullptr;
1116 }
1117
1118 enum FlattenedParentType { eNormal, eForStyle, eForSelection };
1119
1120 /**
1121 * Returns the node that is the parent of this node in the flattened
1122 * tree. This differs from the normal parent if the node is filtered
1123 * into an insertion point, or if the node is a direct child of a
1124 * shadow root.
1125 *
1126 * @return the flattened tree parent
1127 */
1128 inline nsINode* GetFlattenedTreeParentNode() const;
1129
1130 nsINode* GetFlattenedTreeParentNodeNonInline() const;
1131
1132 /**
1133 * Like GetFlattenedTreeParentNode, but returns the document for any native
1134 * anonymous content that was generated for ancestor frames of the document
1135 * element's primary frame, such as scrollbar elements created by the root
1136 * scroll frame.
1137 */
1138 inline nsINode* GetFlattenedTreeParentNodeForStyle() const;
1139
1140 /**
1141 * Similar to GetFlattenedTreeParentNode, it does two things differently
1142 * 1. For contents that are not in the flattened tree, use its
1143 * parent rather than nullptr.
1144 * 2. For contents that are slotted into a UA shadow tree, use its
1145 * parent rather than the slot element.
1146 */
1147 inline nsIContent* GetFlattenedTreeParentNodeForSelection() const;
1148
1149 inline mozilla::dom::Element* GetFlattenedTreeParentElement() const;
1150 inline mozilla::dom::Element* GetFlattenedTreeParentElementForStyle() const;
1151
1152 /**
1153 * Get the parent nsINode for this node if it is an Element.
1154 *
1155 * Defined inline in Element.h
1156 *
1157 * @return the parent node
1158 */
1159 inline mozilla::dom::Element* GetParentElement() const;
1160
1161 /**
1162 * Get the parent Element of this node, traversing over a ShadowRoot
1163 * to its host if necessary.
1164 */
1165 mozilla::dom::Element* GetParentElementCrossingShadowRoot() const;
1166
1167 /**
1168 * Get closest element node for the node. Meaning that if the node is an
1169 * element node, returns itself. Otherwise, returns parent element or null.
1170 */
1171 inline mozilla::dom::Element* GetAsElementOrParentElement() const;
1172
1173 /**
1174 * Get inclusive ancestor element in the flattened tree.
1175 */
1176 inline mozilla::dom::Element* GetInclusiveFlattenedTreeAncestorElement()
1177 const;
1178
1179 /**
1180 * Get the root of the subtree this node belongs to. This never returns
1181 * null. It may return 'this' (e.g. for document nodes, and nodes that
1182 * are the roots of disconnected subtrees).
1183 */
1184 nsINode* SubtreeRoot() const;
1185
1186 /*
1187 * Get context object's shadow-including root if options's composed is true,
1188 * and context object's root otherwise.
1189 */
1190 nsINode* GetRootNode(const mozilla::dom::GetRootNodeOptions& aOptions);
1191
1192 virtual mozilla::EventListenerManager* GetExistingListenerManager()
1193 const override;
1194 virtual mozilla::EventListenerManager* GetOrCreateListenerManager() override;
1195
1196 mozilla::Maybe<mozilla::dom::EventCallbackDebuggerNotificationType>
1197 GetDebuggerNotificationType() const override;
1198
1199 bool ComputeDefaultWantsUntrusted(mozilla::ErrorResult& aRv) final;
1200
1201 virtual bool IsApzAware() const override;
1202
1203 virtual nsPIDOMWindowOuter* GetOwnerGlobalForBindingsInternal() override;
1204 virtual nsIGlobalObject* GetOwnerGlobal() const override;
1205
1206 using mozilla::dom::EventTarget::DispatchEvent;
1207 // TODO: Convert this to MOZ_CAN_RUN_SCRIPT (bug 1415230)
1208 MOZ_CAN_RUN_SCRIPT_BOUNDARY bool DispatchEvent(
1209 mozilla::dom::Event& aEvent, mozilla::dom::CallerType aCallerType,
1210 mozilla::ErrorResult& aRv) override;
1211
1212 MOZ_CAN_RUN_SCRIPT
1213 nsresult PostHandleEvent(mozilla::EventChainPostVisitor& aVisitor) override;
1214
1215 /**
1216 * Adds a mutation observer to be notified when this node, or any of its
1217 * descendants, are modified. The node will hold a weak reference to the
1218 * observer, which means that it is the responsibility of the observer to
1219 * remove itself in case it dies before the node. If an observer is added
1220 * while observers are being notified, it may also be notified. In general,
1221 * adding observers while inside a notification is not a good idea. An
1222 * observer that is already observing the node must not be added without
1223 * being removed first.
1224 *
1225 * For mutation observers that implement nsIAnimationObserver, use
1226 * AddAnimationObserver instead.
1227 */
1228 void AddMutationObserver(nsIMutationObserver* aMutationObserver) {
1229 nsSlots* s = Slots();
1230 if (aMutationObserver) {
1231 NS_ASSERTION(!s->mMutationObservers.contains(aMutationObserver),do { if (!(!s->mMutationObservers.contains(aMutationObserver
))) { NS_DebugBreak(NS_DEBUG_ASSERTION, "Observer already in the list"
, "!s->mMutationObservers.contains(aMutationObserver)", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 1232); MOZ_PretendNoReturn(); } } while (0)
1232 "Observer already in the list")do { if (!(!s->mMutationObservers.contains(aMutationObserver
))) { NS_DebugBreak(NS_DEBUG_ASSERTION, "Observer already in the list"
, "!s->mMutationObservers.contains(aMutationObserver)", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 1232); MOZ_PretendNoReturn(); } } while (0)
;
1233
1234 s->mMutationObservers.pushBack(aMutationObserver);
1235 }
1236 }
1237
1238 void AddMutationObserver(nsMultiMutationObserver* aMultiMutationObserver);
1239
1240 /**
1241 * Same as above, but only adds the observer if its not observing
1242 * the node already.
1243 *
1244 * For mutation observers that implement nsIAnimationObserver, use
1245 * AddAnimationObserverUnlessExists instead.
1246 */
1247 void AddMutationObserverUnlessExists(nsIMutationObserver* aMutationObserver) {
1248 nsSlots* s = Slots();
1249 if (aMutationObserver &&
1250 !s->mMutationObservers.contains(aMutationObserver)) {
1251 s->mMutationObservers.pushBack(aMutationObserver);
1252 }
1253 }
1254
1255 void AddMutationObserverUnlessExists(
1256 nsMultiMutationObserver* aMultiMutationObserver);
1257 /**
1258 * Same as AddMutationObserver, but for nsIAnimationObservers. This
1259 * additionally records on the document that animation observers have
1260 * been registered, which is used to determine whether notifications
1261 * must be fired when animations are added, removed or changed.
1262 */
1263 void AddAnimationObserver(nsIAnimationObserver* aAnimationObserver);
1264
1265 /**
1266 * Same as above, but only adds the observer if its not observing
1267 * the node already.
1268 */
1269 void AddAnimationObserverUnlessExists(
1270 nsIAnimationObserver* aAnimationObserver);
1271
1272 /**
1273 * Removes a mutation observer.
1274 */
1275 void RemoveMutationObserver(nsIMutationObserver* aMutationObserver) {
1276 nsSlots* s = GetExistingSlots();
1277 if (s) {
1278 s->mMutationObservers.remove(aMutationObserver);
1279 }
1280 }
1281
1282 void RemoveMutationObserver(nsMultiMutationObserver* aMultiMutationObserver);
1283
1284 mozilla::SafeDoublyLinkedList<nsIMutationObserver>* GetMutationObservers();
1285
1286 /**
1287 * Helper methods to access ancestor node(s) of type T.
1288 * The implementations of the methods are in mozilla/dom/AncestorIterator.h.
1289 */
1290 template <typename T>
1291 inline mozilla::dom::AncestorsOfTypeIterator<T> AncestorsOfType() const;
1292
1293 template <typename T>
1294 inline mozilla::dom::InclusiveAncestorsOfTypeIterator<T>
1295 InclusiveAncestorsOfType() const;
1296
1297 template <typename T>
1298 inline mozilla::dom::FlatTreeAncestorsOfTypeIterator<T>
1299 FlatTreeAncestorsOfType() const;
1300
1301 template <typename T>
1302 inline mozilla::dom::InclusiveFlatTreeAncestorsOfTypeIterator<T>
1303 InclusiveFlatTreeAncestorsOfType() const;
1304
1305 template <typename T>
1306 T* FirstAncestorOfType() const;
1307
1308 private:
1309 /**
1310 * Walks aNode, its attributes and, if aDeep is true, its descendant nodes.
1311 * If aClone is true the nodes will be cloned. If aNewNodeInfoManager is
1312 * not null, it is used to create new nodeinfos for the nodes. Also reparents
1313 * the XPConnect wrappers for the nodes into aReparentScope if non-null.
1314 *
1315 * @param aNode Node to adopt/clone.
1316 * @param aClone If true the node will be cloned and the cloned node will
1317 * be returned.
1318 * @param aDeep If true the function will be called recursively on
1319 * descendants of the node
1320 * @param aNewNodeInfoManager The nodeinfo manager to use to create new
1321 * nodeinfos for aNode and its attributes and
1322 * descendants. May be null if the nodeinfos
1323 * shouldn't be changed.
1324 * @param aReparentScope Scope into which wrappers should be reparented, or
1325 * null if no reparenting should be done.
1326 * @param aParent If aClone is true the cloned node will be appended to
1327 * aParent's children. May be null. If not null then aNode
1328 * must be an nsIContent.
1329 * @param aError The error, if any.
1330 *
1331 * @return If aClone is true then the cloned node will be returned,
1332 * unless an error occurred. In error conditions, null
1333 * will be returned.
1334 */
1335 static already_AddRefed<nsINode> CloneAndAdopt(
1336 nsINode* aNode, bool aClone, bool aDeep,
1337 nsNodeInfoManager* aNewNodeInfoManager,
1338 JS::Handle<JSObject*> aReparentScope, nsINode* aParent,
1339 mozilla::ErrorResult& aError);
1340
1341 public:
1342 /**
1343 * Walks the node, its attributes and descendant nodes. If aNewNodeInfoManager
1344 * is not null, it is used to create new nodeinfos for the nodes. Also
1345 * reparents the XPConnect wrappers for the nodes into aReparentScope if
1346 * non-null.
1347 *
1348 * @param aNewNodeInfoManager The nodeinfo manager to use to create new
1349 * nodeinfos for the node and its attributes and
1350 * descendants. May be null if the nodeinfos
1351 * shouldn't be changed.
1352 * @param aReparentScope New scope for the wrappers, or null if no reparenting
1353 * should be done.
1354 * @param aError The error, if any.
1355 */
1356 void Adopt(nsNodeInfoManager* aNewNodeInfoManager,
1357 JS::Handle<JSObject*> aReparentScope,
1358 mozilla::ErrorResult& aError);
1359
1360 /**
1361 * Clones the node, its attributes and, if aDeep is true, its descendant nodes
1362 * If aNewNodeInfoManager is not null, it is used to create new nodeinfos for
1363 * the clones.
1364 *
1365 * @param aDeep If true the function will be called recursively on
1366 * descendants of the node
1367 * @param aNewNodeInfoManager The nodeinfo manager to use to create new
1368 * nodeinfos for the node and its attributes and
1369 * descendants. May be null if the nodeinfos
1370 * shouldn't be changed.
1371 * @param aError The error, if any.
1372 *
1373 * @return The newly created node. Null in error conditions.
1374 */
1375 already_AddRefed<nsINode> Clone(bool aDeep,
1376 nsNodeInfoManager* aNewNodeInfoManager,
1377 mozilla::ErrorResult& aError);
1378
1379 /**
1380 * Clones this node. This needs to be overriden by all node classes. aNodeInfo
1381 * should be identical to this node's nodeInfo, except for the document which
1382 * may be different. When cloning an element, all attributes of the element
1383 * will be cloned. The children of the node will not be cloned.
1384 *
1385 * @param aNodeInfo the nodeinfo to use for the clone
1386 * @param aResult the clone
1387 */
1388 virtual nsresult Clone(mozilla::dom::NodeInfo*, nsINode** aResult) const = 0;
1389
1390 // A callback that gets called when we are forcefully unbound from a node (due
1391 // to the node going away). You shouldn't take a strong ref to the node from
1392 // the callback.
1393 using UnbindCallback = void (*)(nsISupports*, nsINode*);
1394 // We should keep alive these objects.
1395 struct BoundObject {
1396 nsCOMPtr<nsISupports> mObject;
1397 UnbindCallback mDtor = nullptr;
1398
1399 BoundObject(nsISupports* aObject, UnbindCallback aDtor)
1400 : mObject(aObject), mDtor(aDtor) {}
1401
1402 bool operator==(nsISupports* aOther) const {
1403 return mObject.get() == aOther;
1404 }
1405 };
1406
1407 // This class can be extended by subclasses that wish to store more
1408 // information in the slots.
1409 class nsSlots {
1410 public:
1411 nsSlots();
1412
1413 // If needed we could remove the vtable pointer this dtor causes by
1414 // putting a DestroySlots function on nsINode
1415 virtual ~nsSlots();
1416
1417 virtual void Traverse(nsCycleCollectionTraversalCallback&);
1418 virtual void Unlink(nsINode&);
1419
1420 /**
1421 * A list of mutation observers
1422 */
1423 mozilla::SafeDoublyLinkedList<nsIMutationObserver> mMutationObservers;
1424
1425 /**
1426 * An object implementing NodeList for this content (childNodes)
1427 * @see NodeList
1428 * @see nsGenericHTMLElement::GetChildNodes
1429 */
1430 RefPtr<nsAttrChildContentList> mChildNodes;
1431
1432 /**
1433 * Weak reference to this node. This is cleared by the destructor of
1434 * nsNodeWeakReference.
1435 */
1436 nsNodeWeakReference* MOZ_NON_OWNING_REF mWeakReference;
1437
1438 /** A list of objects that we should keep alive. See Bind/UnbindObject. */
1439 nsTArray<BoundObject> mBoundObjects;
1440
1441 /**
1442 * A set of ranges which are in the selection and which have this node as
1443 * their endpoints' closest common inclusive ancestor
1444 * (https://dom.spec.whatwg.org/#concept-tree-inclusive-ancestor). This is
1445 * a UniquePtr instead of just a LinkedList, because that prevents us from
1446 * pushing DOMSlots up to the next allocation bucket size, at the cost of
1447 * some complexity.
1448 */
1449 mozilla::UniquePtr<mozilla::LinkedList<mozilla::dom::AbstractRange>>
1450 mClosestCommonInclusiveAncestorRanges;
1451 };
1452
1453 /**
1454 * Functions for managing flags and slots
1455 */
1456#ifdef DEBUG1
1457 nsSlots* DebugGetSlots() { return Slots(); }
1458#endif
1459
1460 void SetFlags(FlagsType aFlagsToSet) {
1461 NS_ASSERTION(do { if (!(!(aFlagsToSet & (NODE_IS_NATIVE_ANONYMOUS_ROOT
| NODE_IS_IN_NATIVE_ANONYMOUS_SUBTREE | NODE_DESCENDANTS_NEED_FRAMES
| NODE_NEEDS_FRAME | NODE_HAS_BEEN_IN_UA_WIDGET)) || IsContent
())) { NS_DebugBreak(NS_DEBUG_ASSERTION, "Flag only permitted on nsIContent nodes"
, "!(aFlagsToSet & (NODE_IS_NATIVE_ANONYMOUS_ROOT | NODE_IS_IN_NATIVE_ANONYMOUS_SUBTREE | NODE_DESCENDANTS_NEED_FRAMES | NODE_NEEDS_FRAME | NODE_HAS_BEEN_IN_UA_WIDGET)) || IsContent()"
, "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 1467); MOZ_PretendNoReturn(); } } while (0)
1462 !(aFlagsToSet &do { if (!(!(aFlagsToSet & (NODE_IS_NATIVE_ANONYMOUS_ROOT
| NODE_IS_IN_NATIVE_ANONYMOUS_SUBTREE | NODE_DESCENDANTS_NEED_FRAMES
| NODE_NEEDS_FRAME | NODE_HAS_BEEN_IN_UA_WIDGET)) || IsContent
())) { NS_DebugBreak(NS_DEBUG_ASSERTION, "Flag only permitted on nsIContent nodes"
, "!(aFlagsToSet & (NODE_IS_NATIVE_ANONYMOUS_ROOT | NODE_IS_IN_NATIVE_ANONYMOUS_SUBTREE | NODE_DESCENDANTS_NEED_FRAMES | NODE_NEEDS_FRAME | NODE_HAS_BEEN_IN_UA_WIDGET)) || IsContent()"
, "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 1467); MOZ_PretendNoReturn(); } } while (0)
1463 (NODE_IS_NATIVE_ANONYMOUS_ROOT | NODE_IS_IN_NATIVE_ANONYMOUS_SUBTREE |do { if (!(!(aFlagsToSet & (NODE_IS_NATIVE_ANONYMOUS_ROOT
| NODE_IS_IN_NATIVE_ANONYMOUS_SUBTREE | NODE_DESCENDANTS_NEED_FRAMES
| NODE_NEEDS_FRAME | NODE_HAS_BEEN_IN_UA_WIDGET)) || IsContent
())) { NS_DebugBreak(NS_DEBUG_ASSERTION, "Flag only permitted on nsIContent nodes"
, "!(aFlagsToSet & (NODE_IS_NATIVE_ANONYMOUS_ROOT | NODE_IS_IN_NATIVE_ANONYMOUS_SUBTREE | NODE_DESCENDANTS_NEED_FRAMES | NODE_NEEDS_FRAME | NODE_HAS_BEEN_IN_UA_WIDGET)) || IsContent()"
, "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 1467); MOZ_PretendNoReturn(); } } while (0)
1464 NODE_DESCENDANTS_NEED_FRAMES | NODE_NEEDS_FRAME |do { if (!(!(aFlagsToSet & (NODE_IS_NATIVE_ANONYMOUS_ROOT
| NODE_IS_IN_NATIVE_ANONYMOUS_SUBTREE | NODE_DESCENDANTS_NEED_FRAMES
| NODE_NEEDS_FRAME | NODE_HAS_BEEN_IN_UA_WIDGET)) || IsContent
())) { NS_DebugBreak(NS_DEBUG_ASSERTION, "Flag only permitted on nsIContent nodes"
, "!(aFlagsToSet & (NODE_IS_NATIVE_ANONYMOUS_ROOT | NODE_IS_IN_NATIVE_ANONYMOUS_SUBTREE | NODE_DESCENDANTS_NEED_FRAMES | NODE_NEEDS_FRAME | NODE_HAS_BEEN_IN_UA_WIDGET)) || IsContent()"
, "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 1467); MOZ_PretendNoReturn(); } } while (0)
1465 NODE_HAS_BEEN_IN_UA_WIDGET)) ||do { if (!(!(aFlagsToSet & (NODE_IS_NATIVE_ANONYMOUS_ROOT
| NODE_IS_IN_NATIVE_ANONYMOUS_SUBTREE | NODE_DESCENDANTS_NEED_FRAMES
| NODE_NEEDS_FRAME | NODE_HAS_BEEN_IN_UA_WIDGET)) || IsContent
())) { NS_DebugBreak(NS_DEBUG_ASSERTION, "Flag only permitted on nsIContent nodes"
, "!(aFlagsToSet & (NODE_IS_NATIVE_ANONYMOUS_ROOT | NODE_IS_IN_NATIVE_ANONYMOUS_SUBTREE | NODE_DESCENDANTS_NEED_FRAMES | NODE_NEEDS_FRAME | NODE_HAS_BEEN_IN_UA_WIDGET)) || IsContent()"
, "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 1467); MOZ_PretendNoReturn(); } } while (0)
1466 IsContent(),do { if (!(!(aFlagsToSet & (NODE_IS_NATIVE_ANONYMOUS_ROOT
| NODE_IS_IN_NATIVE_ANONYMOUS_SUBTREE | NODE_DESCENDANTS_NEED_FRAMES
| NODE_NEEDS_FRAME | NODE_HAS_BEEN_IN_UA_WIDGET)) || IsContent
())) { NS_DebugBreak(NS_DEBUG_ASSERTION, "Flag only permitted on nsIContent nodes"
, "!(aFlagsToSet & (NODE_IS_NATIVE_ANONYMOUS_ROOT | NODE_IS_IN_NATIVE_ANONYMOUS_SUBTREE | NODE_DESCENDANTS_NEED_FRAMES | NODE_NEEDS_FRAME | NODE_HAS_BEEN_IN_UA_WIDGET)) || IsContent()"
, "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 1467); MOZ_PretendNoReturn(); } } while (0)
1467 "Flag only permitted on nsIContent nodes")do { if (!(!(aFlagsToSet & (NODE_IS_NATIVE_ANONYMOUS_ROOT
| NODE_IS_IN_NATIVE_ANONYMOUS_SUBTREE | NODE_DESCENDANTS_NEED_FRAMES
| NODE_NEEDS_FRAME | NODE_HAS_BEEN_IN_UA_WIDGET)) || IsContent
())) { NS_DebugBreak(NS_DEBUG_ASSERTION, "Flag only permitted on nsIContent nodes"
, "!(aFlagsToSet & (NODE_IS_NATIVE_ANONYMOUS_ROOT | NODE_IS_IN_NATIVE_ANONYMOUS_SUBTREE | NODE_DESCENDANTS_NEED_FRAMES | NODE_NEEDS_FRAME | NODE_HAS_BEEN_IN_UA_WIDGET)) || IsContent()"
, "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 1467); MOZ_PretendNoReturn(); } } while (0)
;
1468 nsWrapperCache::SetFlags(aFlagsToSet);
1469 }
1470
1471 void UnsetFlags(FlagsType aFlagsToUnset) {
1472 NS_ASSERTION(!(aFlagsToUnset & (NODE_HAS_BEEN_IN_UA_WIDGET |do { if (!(!(aFlagsToUnset & (NODE_HAS_BEEN_IN_UA_WIDGET |
NODE_IS_NATIVE_ANONYMOUS_ROOT)))) { NS_DebugBreak(NS_DEBUG_ASSERTION
, "Trying to unset write-only flags", "!(aFlagsToUnset & (NODE_HAS_BEEN_IN_UA_WIDGET | NODE_IS_NATIVE_ANONYMOUS_ROOT))"
, "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 1474); MOZ_PretendNoReturn(); } } while (0)
1473 NODE_IS_NATIVE_ANONYMOUS_ROOT)),do { if (!(!(aFlagsToUnset & (NODE_HAS_BEEN_IN_UA_WIDGET |
NODE_IS_NATIVE_ANONYMOUS_ROOT)))) { NS_DebugBreak(NS_DEBUG_ASSERTION
, "Trying to unset write-only flags", "!(aFlagsToUnset & (NODE_HAS_BEEN_IN_UA_WIDGET | NODE_IS_NATIVE_ANONYMOUS_ROOT))"
, "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 1474); MOZ_PretendNoReturn(); } } while (0)
1474 "Trying to unset write-only flags")do { if (!(!(aFlagsToUnset & (NODE_HAS_BEEN_IN_UA_WIDGET |
NODE_IS_NATIVE_ANONYMOUS_ROOT)))) { NS_DebugBreak(NS_DEBUG_ASSERTION
, "Trying to unset write-only flags", "!(aFlagsToUnset & (NODE_HAS_BEEN_IN_UA_WIDGET | NODE_IS_NATIVE_ANONYMOUS_ROOT))"
, "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 1474); MOZ_PretendNoReturn(); } } while (0)
;
1475 nsWrapperCache::UnsetFlags(aFlagsToUnset);
1476 }
1477
1478 void SetEditableFlag(bool aEditable) {
1479 if (aEditable) {
1480 SetFlags(NODE_IS_EDITABLE);
1481 } else {
1482 UnsetFlags(NODE_IS_EDITABLE);
1483 }
1484 }
1485
1486 inline bool IsEditable() const;
1487
1488 /**
1489 * Check if this node is an editing host. For avoiding confusion, this always
1490 * returns false if the node is in the design mode document.
1491 */
1492 inline bool IsEditingHost() const;
1493
1494 /**
1495 * Check if this node is in design mode or not. When this returns true and:
1496 * - if this is a Document node, it's the design mode root.
1497 * - if this is a content node, it's connected, it's not in a shadow tree
1498 * (except shadow tree for UI widget and native anonymous subtree) and its
1499 * uncomposed document is in design mode.
1500 * Note that returning true does NOT mean the node or its children is
1501 * editable. E.g., when this node is in a shadow tree of a UA widget and its
1502 * host is in design mode.
1503 */
1504 inline bool IsInDesignMode() const;
1505
1506 /**
1507 * Returns true if |this| or any of its ancestors is native anonymous.
1508 */
1509 bool IsInNativeAnonymousSubtree() const {
1510 return HasFlag(NODE_IS_IN_NATIVE_ANONYMOUS_SUBTREE);
1511 }
1512
1513 /**
1514 * If |this| or any ancestor is native anonymous, return the root of the
1515 * native anonymous subtree. Note that in case of nested native anonymous
1516 * content, this returns the innermost root, not the outermost.
1517 */
1518 nsIContent* GetClosestNativeAnonymousSubtreeRoot() const {
1519 if (!IsInNativeAnonymousSubtree()) {
1520 MOZ_ASSERT(!HasBeenInUAWidget(), "UA widget implies anonymous")do { static_assert( mozilla::detail::AssertionConditionType<
decltype(!HasBeenInUAWidget())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(!HasBeenInUAWidget()))), 0))
) { do { } while (false); MOZ_ReportAssertionFailure("!HasBeenInUAWidget()"
" (" "UA widget implies anonymous" ")", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 1520); AnnotateMozCrashReason("MOZ_ASSERT" "(" "!HasBeenInUAWidget()"
") (" "UA widget implies anonymous" ")"); do { *((volatile int
*)__null) = 1520; __attribute__((nomerge)) ::abort(); } while
(false); } } while (false)
;
1521 return nullptr;
1522 }
1523 MOZ_ASSERT(IsContent(), "How did non-content end up in NAC?")do { static_assert( mozilla::detail::AssertionConditionType<
decltype(IsContent())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(IsContent()))), 0))) { do { }
while (false); MOZ_ReportAssertionFailure("IsContent()" " ("
"How did non-content end up in NAC?" ")", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 1523); AnnotateMozCrashReason("MOZ_ASSERT" "(" "IsContent()"
") (" "How did non-content end up in NAC?" ")"); do { *((volatile
int*)__null) = 1523; __attribute__((nomerge)) ::abort(); } while
(false); } } while (false)
;
1524 if (HasBeenInUAWidget()) {
1525 // reinterpret_cast because in this header we don't know ShadowRoot is an
1526 // nsIContent. ShadowRoot constructor asserts this is correct.
1527 return reinterpret_cast<nsIContent*>(GetContainingShadow());
1528 }
1529 for (const nsINode* node = this; node; node = node->GetParentNode()) {
1530 if (node->IsRootOfNativeAnonymousSubtree()) {
1531 return const_cast<nsINode*>(node)->AsContent();
1532 }
1533 }
1534 // FIXME(emilio): This should not happen, usually, but editor removes nodes
1535 // in native anonymous subtrees, and we don't clean nodes from the current
1536 // event content stack from ContentRemoved, so it can actually happen, see
1537 // bug 1510208.
1538 NS_WARNING("GetClosestNativeAnonymousSubtreeRoot on disconnected NAC!")NS_DebugBreak(NS_DEBUG_WARNING, "GetClosestNativeAnonymousSubtreeRoot on disconnected NAC!"
, nullptr, "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 1538)
;
1539 return nullptr;
1540 }
1541
1542 /**
1543 * If |this| or any ancestor is native anonymous, return the parent of the
1544 * native anonymous subtree. Note that in case of nested native anonymous
1545 * content, this returns the parent or host of the innermost root, not the
1546 * outermost.
1547 */
1548 nsIContent* GetClosestNativeAnonymousSubtreeRootParentOrHost() const {
1549 // We could put this in nsIContentInlines.h or such to avoid this
1550 // reinterpret_cast, but it doesn't seem worth it.
1551 const auto* root = reinterpret_cast<const nsINode*>(
1552 GetClosestNativeAnonymousSubtreeRoot());
1553 if (!root) {
1554 return nullptr;
1555 }
1556 if (nsIContent* parent = root->GetParent()) {
1557 return parent;
1558 }
1559 if (MOZ_UNLIKELY(root->IsInShadowTree())(__builtin_expect(!!(root->IsInShadowTree()), 0))) {
1560 return root->DoGetShadowHost();
1561 }
1562 return nullptr;
1563 }
1564
1565 /**
1566 * Gets the root of the node tree for this content if it is in a shadow tree.
1567 */
1568 mozilla::dom::ShadowRoot* GetContainingShadow() const;
1569 /**
1570 * Gets the shadow host if this content is in a shadow tree. That is, the host
1571 * of |GetContainingShadow|, if its not null.
1572 *
1573 * @return The shadow host, if this is in shadow tree, or null.
1574 */
1575 mozilla::dom::Element* GetContainingShadowHost() const;
1576
1577 bool IsInSVGUseShadowTree() const {
1578 return !!GetContainingSVGUseShadowHost();
1579 }
1580
1581 mozilla::dom::SVGUseElement* GetContainingSVGUseShadowHost() const {
1582 if (!IsInShadowTree()) {
1583 return nullptr;
1584 }
1585 return DoGetContainingSVGUseShadowHost();
1586 }
1587
1588 // Whether this node has ever been part of a UA widget shadow tree.
1589 bool HasBeenInUAWidget() const { return HasFlag(NODE_HAS_BEEN_IN_UA_WIDGET); }
1590
1591 // True for native anonymous content and for content in UA widgets.
1592 // Only nsIContent can fulfill this condition.
1593 bool ChromeOnlyAccess() const { return IsInNativeAnonymousSubtree(); }
1594
1595 const nsIContent* GetChromeOnlyAccessSubtreeRootParent() const {
1596 return GetClosestNativeAnonymousSubtreeRootParentOrHost();
1597 }
1598
1599 bool IsInShadowTree() const { return HasFlag(NODE_IS_IN_SHADOW_TREE); }
1600
1601 /**
1602 * Get whether this node is C++-generated anonymous content
1603 * @see nsIAnonymousContentCreator
1604 * @return whether this content is anonymous
1605 */
1606 bool IsRootOfNativeAnonymousSubtree() const {
1607 NS_ASSERTION(do { if (!(!HasFlag(NODE_IS_NATIVE_ANONYMOUS_ROOT) || IsInNativeAnonymousSubtree
())) { NS_DebugBreak(NS_DEBUG_ASSERTION, "Some flags seem to be missing!"
, "!HasFlag(NODE_IS_NATIVE_ANONYMOUS_ROOT) || IsInNativeAnonymousSubtree()"
, "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 1609); MOZ_PretendNoReturn(); } } while (0)
1608 !HasFlag(NODE_IS_NATIVE_ANONYMOUS_ROOT) || IsInNativeAnonymousSubtree(),do { if (!(!HasFlag(NODE_IS_NATIVE_ANONYMOUS_ROOT) || IsInNativeAnonymousSubtree
())) { NS_DebugBreak(NS_DEBUG_ASSERTION, "Some flags seem to be missing!"
, "!HasFlag(NODE_IS_NATIVE_ANONYMOUS_ROOT) || IsInNativeAnonymousSubtree()"
, "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 1609); MOZ_PretendNoReturn(); } } while (0)
1609 "Some flags seem to be missing!")do { if (!(!HasFlag(NODE_IS_NATIVE_ANONYMOUS_ROOT) || IsInNativeAnonymousSubtree
())) { NS_DebugBreak(NS_DEBUG_ASSERTION, "Some flags seem to be missing!"
, "!HasFlag(NODE_IS_NATIVE_ANONYMOUS_ROOT) || IsInNativeAnonymousSubtree()"
, "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 1609); MOZ_PretendNoReturn(); } } while (0)
;
1610 return HasFlag(NODE_IS_NATIVE_ANONYMOUS_ROOT);
1611 }
1612
1613 // Whether this node is the root of a ChromeOnlyAccess DOM subtree.
1614 bool IsRootOfChromeAccessOnlySubtree() const {
1615 return IsRootOfNativeAnonymousSubtree();
1616 }
1617
1618 /** Whether this is the container of a ::before pseudo-element. */
1619 bool IsGeneratedContentContainerForBefore() const {
1620 return IsRootOfNativeAnonymousSubtree() &&
1621 mNodeInfo->NameAtom() == nsGkAtoms::mozgeneratedcontentbefore;
1622 }
1623
1624 /** Whether this is the container of an ::after pseudo-element. */
1625 bool IsGeneratedContentContainerForAfter() const {
1626 return IsRootOfNativeAnonymousSubtree() &&
1627 mNodeInfo->NameAtom() == nsGkAtoms::mozgeneratedcontentafter;
1628 }
1629
1630 /** Whether this is the container of a ::marker pseudo-element. */
1631 bool IsGeneratedContentContainerForMarker() const {
1632 return IsRootOfNativeAnonymousSubtree() &&
1633 mNodeInfo->NameAtom() == nsGkAtoms::mozgeneratedcontentmarker;
1634 }
1635
1636 /**
1637 * Returns true if |this| node is the closest common inclusive ancestor
1638 * (https://dom.spec.whatwg.org/#concept-tree-inclusive-ancestor) of the
1639 * start/end nodes of a Range in a Selection or a descendant of such a common
1640 * ancestor. This node is definitely not selected when |false| is returned,
1641 * but it may or may not be selected when |true| is returned.
1642 */
1643 bool IsMaybeSelected() const {
1644 return IsDescendantOfClosestCommonInclusiveAncestorForRangeInSelection() ||
1645 IsClosestCommonInclusiveAncestorForRangeInSelection();
1646 }
1647
1648 /**
1649 * Return true if any part of (this, aStartOffset) .. (this, aEndOffset)
1650 * overlaps any nsRange in
1651 * GetClosestCommonInclusiveAncestorForRangeInSelection ranges (i.e.
1652 * where this is a descendant of a range's common inclusive ancestor node).
1653 * If a nsRange starts in (this, aEndOffset) or if it ends in
1654 * (this, aStartOffset) then it is non-overlapping and the result is false
1655 * for that nsRange. Collapsed ranges always counts as non-overlapping.
1656 *
1657 * @param aStartOffset has to be less or equal to aEndOffset.
1658 * @param aCache A cache which contains all fully selected nodes for each
1659 * selection. If present, this provides a fast path to check if
1660 * a node is fully selected.
1661 */
1662 bool IsSelected(uint32_t aStartOffset, uint32_t aEndOffset,
1663 mozilla::dom::SelectionNodeCache* aCache = nullptr) const;
1664
1665 /**
1666 * Get the root element of the text editor associated with this node or the
1667 * root element of the text editor of the ancestor 'TextControlElement' if
1668 * this is in its native anonymous subtree. I.e., this returns anonymous
1669 * `<div>` element of a `TextEditor`. Note that this can be used only for
1670 * getting root content of `<input>` or `<textarea>`. I.e., this method
1671 * doesn't support HTML editors. Note that this may create a `TextEditor`
1672 * instance, and it means that the `TextEditor` may modify its native
1673 * anonymous subtree and may run selection listeners.
1674 */
1675 MOZ_CAN_RUN_SCRIPT mozilla::dom::Element* GetAnonymousRootElementOfTextEditor(
1676 mozilla::TextEditor** aTextEditor = nullptr);
1677
1678 /**
1679 * Get the nearest selection root, ie. the node that will be selected if the
1680 * user does "Select All" while the focus is in this node. Note that if this
1681 * node is not in an editor, the result comes from the nsFrameSelection that
1682 * is related to aPresShell, so the result might not be the ancestor of this
1683 * node. Be aware that if this node and the computed selection limiter are
1684 * not in same subtree, this returns the root content of the closeset subtree.
1685 */
1686 MOZ_CAN_RUN_SCRIPT nsIContent* GetSelectionRootContent(
1687 mozilla::PresShell* aPresShell, bool aAllowCrossShadowBoundary = false);
1688
1689 bool HasScheduledSelectionChangeEvent() {
1690 return HasFlag(NODE_HAS_SCHEDULED_SELECTION_CHANGE_EVENT);
1691 }
1692
1693 void SetHasScheduledSelectionChangeEvent() {
1694 SetFlags(NODE_HAS_SCHEDULED_SELECTION_CHANGE_EVENT);
1695 }
1696
1697 void ClearHasScheduledSelectionChangeEvent() {
1698 UnsetFlags(NODE_HAS_SCHEDULED_SELECTION_CHANGE_EVENT);
1699 }
1700
1701 nsINodeList* ChildNodes();
1702
1703 nsIContent* GetFirstChild() const { return mFirstChild; }
1704
1705 nsIContent* GetLastChild() const;
1706
1707 /**
1708 * Implementation is in Document.h, because it needs to cast from
1709 * Document* to nsINode*.
1710 */
1711 Document* GetOwnerDocument() const;
1712
1713 // TODO: Convert this to MOZ_CAN_RUN_SCRIPT (bug 1415230)
1714 MOZ_CAN_RUN_SCRIPT_BOUNDARY void Normalize();
1715
1716 /**
1717 * Get the base URI for any relative URIs within this piece of
1718 * content. Generally, this is the document's base URI, but certain
1719 * content carries a local base for backward compatibility.
1720 *
1721 * @return the base URI. May return null.
1722 */
1723 virtual nsIURI* GetBaseURI(bool aTryUseXHRDocBaseURI = false) const = 0;
1724 nsIURI* GetBaseURIObject() const;
1725
1726 /**
1727 * Return true if the node may be apz aware. There are two cases. One is that
1728 * the node is apz aware (such as HTMLInputElement with number type). The
1729 * other is that the node has apz aware listeners. This is a non-virtual
1730 * function which calls IsNodeApzAwareInternal only when the MayBeApzAware is
1731 * set. We check the details in IsNodeApzAwareInternal which may be overriden
1732 * by child classes
1733 */
1734 bool IsNodeApzAware() const {
1735 return NodeMayBeApzAware() ? IsNodeApzAwareInternal() : false;
1736 }
1737
1738 /**
1739 * Override this function and set the flag MayBeApzAware in case the node has
1740 * to let APZC be aware of it. It's used when the node may handle the apz
1741 * aware events and may do preventDefault to stop APZC to do default actions.
1742 *
1743 * For example, instead of scrolling page by APZ, we handle mouse wheel event
1744 * in HTMLInputElement with number type as increasing / decreasing its value.
1745 */
1746 virtual bool IsNodeApzAwareInternal() const;
1747
1748 void GetTextContent(nsAString& aTextContent, mozilla::OOMReporter& aError) {
1749 GetTextContentInternal(aTextContent, aError);
1750 }
1751 void SetTextContent(const nsAString& aTextContent,
1752 nsIPrincipal* aSubjectPrincipal,
1753 mozilla::ErrorResult& aError) {
1754 SetTextContentInternal(aTextContent, aSubjectPrincipal, aError);
1755 }
1756 void SetTextContent(const nsAString& aTextContent,
1757 mozilla::ErrorResult& aError) {
1758 SetTextContentInternal(aTextContent, nullptr, aError);
1759 }
1760
1761 mozilla::dom::Element* QuerySelector(const nsACString& aSelector,
1762 mozilla::ErrorResult& aResult);
1763 already_AddRefed<nsINodeList> QuerySelectorAll(const nsACString& aSelector,
1764 mozilla::ErrorResult& aResult);
1765
1766 protected:
1767 // Document and ShadowRoot override this with its own (faster) version.
1768 // This should really only be called for elements and document fragments.
1769 mozilla::dom::Element* GetElementById(const nsAString& aId);
1770
1771 void AppendChildToChildList(nsIContent* aKid);
1772 void InsertChildToChildList(nsIContent* aKid, nsIContent* aNextSibling);
1773 void DisconnectChild(nsIContent* aKid);
1774
1775 public:
1776 void LookupPrefix(const nsAString& aNamespace, nsAString& aResult);
1777 bool IsDefaultNamespace(const nsAString& aNamespaceURI) {
1778 nsAutoString defaultNamespace;
1779 LookupNamespaceURI(u""_ns, defaultNamespace);
1780 return aNamespaceURI.Equals(defaultNamespace);
1781 }
1782 void LookupNamespaceURI(const nsAString& aNamespacePrefix,
1783 nsAString& aNamespaceURI);
1784
1785 nsIContent* GetNextSibling() const { return mNextSibling; }
1786 nsIContent* GetPreviousSibling() const;
1787
1788 /**
1789 * Return true if the node is being removed from the parent, it means that
1790 * the node still knows the container which it's disconnected from, but the
1791 * node has already been removed from the child node chain of the container.
1792 * I.e., Return true between a call of DisconnectChild of the parent and
1793 * a call of UnbindFromTree of the node.
1794 */
1795 bool IsBeingRemoved() const {
1796 return mParent && !mNextSibling && !mPreviousOrLastSibling;
1797 }
1798
1799 /**
1800 * Get the next node in the pre-order tree traversal of the DOM. If
1801 * aRoot is non-null, then it must be an ancestor of |this|
1802 * (possibly equal to |this|) and only nodes that are descendants of
1803 * aRoot, not including aRoot itself, will be returned. Returns
1804 * null if there are no more nodes to traverse.
1805 */
1806 nsIContent* GetNextNode(const nsINode* aRoot = nullptr) const {
1807 return GetNextNodeImpl(aRoot, false);
1808 }
1809
1810 /**
1811 * Get the next node in the pre-order tree traversal of the DOM but ignoring
1812 * the children of this node. If aRoot is non-null, then it must be an
1813 * ancestor of |this| (possibly equal to |this|) and only nodes that are
1814 * descendants of aRoot, not including aRoot itself, will be returned.
1815 * Returns null if there are no more nodes to traverse.
1816 */
1817 nsIContent* GetNextNonChildNode(const nsINode* aRoot = nullptr) const {
1818 return GetNextNodeImpl(aRoot, true);
1819 }
1820
1821 /**
1822 * Returns true if 'this' is either document or element or
1823 * document fragment and aOther is a descendant in the same
1824 * anonymous tree.
1825 */
1826 bool Contains(const nsINode* aOther) const;
1827
1828 bool UnoptimizableCCNode() const;
1829
1830 /**
1831 * Fire a DOMNodeRemoved mutation event for all children of this node
1832 * TODO: Convert this to MOZ_CAN_RUN_SCRIPT (bug 1415230)
1833 */
1834 MOZ_CAN_RUN_SCRIPT_BOUNDARY void FireNodeRemovedForChildren();
1835
1836 void QueueDevtoolsAnonymousEvent(bool aIsRemove);
1837
1838 private:
1839 mozilla::dom::SVGUseElement* DoGetContainingSVGUseShadowHost() const;
1840
1841 nsIContent* GetNextNodeImpl(const nsINode* aRoot,
1842 const bool aSkipChildren) const {
1843#ifdef DEBUG1
1844 if (aRoot) {
1845 // TODO: perhaps nsINode::IsInclusiveDescendantOf could be used instead.
1846 const nsINode* cur = this;
1847 for (; cur; cur = cur->GetParentNode())
1848 if (cur == aRoot) break;
1849 NS_ASSERTION(cur, "aRoot not an ancestor of |this|?")do { if (!(cur)) { NS_DebugBreak(NS_DEBUG_ASSERTION, "aRoot not an ancestor of |this|?"
, "cur", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 1849); MOZ_PretendNoReturn(); } } while (0)
;
1850 }
1851#endif
1852 if (!aSkipChildren) {
1853 nsIContent* kid = GetFirstChild();
1854 if (kid) {
1855 return kid;
1856 }
1857 }
1858 if (this == aRoot) {
1859 return nullptr;
1860 }
1861 const nsINode* cur = this;
1862 while (1) {
1863 nsIContent* next = cur->GetNextSibling();
1864 if (next) {
1865 return next;
1866 }
1867 nsINode* parent = cur->GetParentNode();
1868 if (parent == aRoot) {
1869 return nullptr;
1870 }
1871 cur = parent;
1872 }
1873 MOZ_ASSERT_UNREACHABLE("How did we get here?")do { static_assert( mozilla::detail::AssertionConditionType<
decltype(false)>::isValid, "invalid assertion condition");
if ((__builtin_expect(!!(!(!!(false))), 0))) { do { } while (
false); MOZ_ReportAssertionFailure("false" " (" "MOZ_ASSERT_UNREACHABLE: "
"How did we get here?" ")", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 1873); AnnotateMozCrashReason("MOZ_ASSERT" "(" "false" ") ("
"MOZ_ASSERT_UNREACHABLE: " "How did we get here?" ")"); do {
*((volatile int*)__null) = 1873; __attribute__((nomerge)) ::
abort(); } while (false); } } while (false)
;
1874 }
1875
1876 public:
1877 /**
1878 * Get the previous nsIContent in the pre-order tree traversal of the DOM. If
1879 * aRoot is non-null, then it must be an ancestor of |this|
1880 * (possibly equal to |this|) and only nsIContents that are descendants of
1881 * aRoot, including aRoot itself, will be returned. Returns
1882 * null if there are no more nsIContents to traverse.
1883 */
1884 nsIContent* GetPrevNode(const nsINode* aRoot = nullptr) const {
1885#ifdef DEBUG1
1886 if (aRoot) {
1887 // TODO: perhaps nsINode::IsInclusiveDescendantOf could be used instead.
1888 const nsINode* cur = this;
1889 for (; cur; cur = cur->GetParentNode())
1890 if (cur == aRoot) break;
1891 NS_ASSERTION(cur, "aRoot not an ancestor of |this|?")do { if (!(cur)) { NS_DebugBreak(NS_DEBUG_ASSERTION, "aRoot not an ancestor of |this|?"
, "cur", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 1891); MOZ_PretendNoReturn(); } } while (0)
;
1892 }
1893#endif
1894
1895 if (this == aRoot) {
1896 return nullptr;
1897 }
1898 nsIContent* cur = this->GetParent();
1899 nsIContent* iter = this->GetPreviousSibling();
1900 while (iter) {
1901 cur = iter;
1902 iter = reinterpret_cast<nsINode*>(iter)->GetLastChild();
1903 }
1904 return cur;
1905 }
1906
1907 /**
1908 * Boolean flags
1909 */
1910 private:
1911 enum BooleanFlag {
1912 // Set if we're being used from -moz-element or observed via a mask,
1913 // clipPath, filter or use element.
1914 NodeHasDirectRenderingObservers,
1915 // Set if our parent chain (including this node itself) terminates
1916 // in a document
1917 IsInDocument,
1918 // Set if we're part of the composed doc.
1919 // https://dom.spec.whatwg.org/#connected
1920 IsConnected,
1921 // Set if mParent is an nsIContent
1922 ParentIsContent,
1923 // Set if this node is an Element
1924 NodeIsElement,
1925 // Set if the element has a non-empty id attribute. This can in rare
1926 // cases lie for nsXMLElement, such as when the node has been moved between
1927 // documents with different id mappings.
1928 ElementHasID,
1929 // Set if the element might have a class.
1930 ElementMayHaveClass,
1931 // Set if the element might have inline style.
1932 ElementMayHaveStyle,
1933 // Set if the element has a name attribute set.
1934 ElementHasName,
1935 // Set if the element has a part attribute set.
1936 ElementHasPart,
1937 // Set if the element might have a contenteditable attribute set.
1938 ElementMayHaveContentEditableAttr,
1939 // Set if the node is the closest common inclusive ancestor of the start/end
1940 // nodes of a Range that is in a Selection.
1941 NodeIsClosestCommonInclusiveAncestorForRangeInSelection,
1942 // Set if the node is a descendant of a node with the above bit set.
1943 NodeIsDescendantOfClosestCommonInclusiveAncestorForRangeInSelection,
1944 // Set if CanSkipInCC check has been done for this subtree root.
1945 NodeIsCCMarkedRoot,
1946 // Maybe set if this node is in black subtree.
1947 NodeIsCCBlackTree,
1948 // Maybe set if the node is a root of a subtree
1949 // which needs to be kept in the purple buffer.
1950 NodeIsPurpleRoot,
1951 // Set if the element has some style states locked
1952 ElementHasLockedStyleStates,
1953 // Set if element has pointer locked
1954 ElementHasPointerLock,
1955 // Set if the node may have DOMMutationObserver attached to it.
1956 NodeMayHaveDOMMutationObserver,
1957 // Set if node is Content
1958 NodeIsContent,
1959 // Set if the node has animations or transitions
1960 ElementHasAnimations,
1961 // Set if node has a dir attribute with a valid value (ltr, rtl, or auto).
1962 // Note that we cannot compute this from the dir attribute event state
1963 // flags, because we can't use those to distinguish
1964 // <bdi dir="some-invalid-value"> and <bdi dir="auto">.
1965 NodeHasValidDirAttribute,
1966 // Set if a node in the node's parent chain has dir=auto and nothing
1967 // inbetween nor the node itself establishes its own direction.
1968 NodeAncestorHasDirAuto,
1969 // Set if the node or an ancestor is assigned to a dir=auto slot and
1970 // nothing between nor the node itself establishes its own direction.
1971 // Except for when the node assigned to the dir=auto slot establishes
1972 // its own direction, then the flag is still set.
1973 NodeAffectsDirAutoSlot,
1974 // Set if the node is handling a click.
1975 NodeHandlingClick,
1976 // Set if the element has a parser insertion mode other than "in body",
1977 // per the HTML5 "Parse state" section.
1978 ElementHasWeirdParserInsertionMode,
1979 // Parser sets this flag if it has notified about the node.
1980 ParserHasNotified,
1981 // Sets if the node is apz aware or we have apz aware listeners.
1982 MayBeApzAware,
1983 // Set if the element might have any kind of anonymous content children,
1984 // which would not be found through the element's children list.
1985 ElementMayHaveAnonymousChildren,
1986 // Set if element has CustomElementData.
1987 ElementHasCustomElementData,
1988 // Set if the element was created from prototype cache and
1989 // its l10n attributes haven't been changed.
1990 ElementCreatedFromPrototypeAndHasUnmodifiedL10n,
1991 // Guard value
1992 BooleanFlagCount
1993 };
1994
1995 void SetBoolFlag(BooleanFlag name, bool value) {
1996 static_assert(BooleanFlagCount <= 8 * sizeof(mBoolFlags),
1997 "Too many boolean flags");
1998 mBoolFlags = (mBoolFlags & ~(1 << name)) | (value << name);
1999 }
2000
2001 void SetBoolFlag(BooleanFlag name) {
2002 static_assert(BooleanFlagCount <= 8 * sizeof(mBoolFlags),
2003 "Too many boolean flags");
2004 mBoolFlags |= (1 << name);
2005 }
2006
2007 void ClearBoolFlag(BooleanFlag name) {
2008 static_assert(BooleanFlagCount <= 8 * sizeof(mBoolFlags),
2009 "Too many boolean flags");
2010 mBoolFlags &= ~(1 << name);
2011 }
2012
2013 bool GetBoolFlag(BooleanFlag name) const {
2014 static_assert(BooleanFlagCount <= 8 * sizeof(mBoolFlags),
2015 "Too many boolean flags");
2016 return mBoolFlags & (1 << name);
2017 }
2018
2019 public:
2020 bool HasDirectRenderingObservers() const {
2021 return GetBoolFlag(NodeHasDirectRenderingObservers);
2022 }
2023 void SetHasDirectRenderingObservers(bool aValue) {
2024 SetBoolFlag(NodeHasDirectRenderingObservers, aValue);
2025 }
2026 bool IsContent() const { return GetBoolFlag(NodeIsContent); }
2027 bool HasID() const { return GetBoolFlag(ElementHasID); }
2028 bool MayHaveClass() const { return GetBoolFlag(ElementMayHaveClass); }
2029 void SetMayHaveClass() { SetBoolFlag(ElementMayHaveClass); }
2030 bool MayHaveStyle() const { return GetBoolFlag(ElementMayHaveStyle); }
2031 bool HasName() const { return GetBoolFlag(ElementHasName); }
2032 bool HasPartAttribute() const { return GetBoolFlag(ElementHasPart); }
2033 bool MayHaveContentEditableAttr() const {
2034 return GetBoolFlag(ElementMayHaveContentEditableAttr);
2035 }
2036 /**
2037 * https://dom.spec.whatwg.org/#concept-tree-inclusive-ancestor
2038 */
2039 bool IsClosestCommonInclusiveAncestorForRangeInSelection() const {
2040 return GetBoolFlag(NodeIsClosestCommonInclusiveAncestorForRangeInSelection);
2041 }
2042 /**
2043 * https://dom.spec.whatwg.org/#concept-tree-inclusive-ancestor
2044 */
2045 void SetClosestCommonInclusiveAncestorForRangeInSelection() {
2046 SetBoolFlag(NodeIsClosestCommonInclusiveAncestorForRangeInSelection);
2047 }
2048 /**
2049 * https://dom.spec.whatwg.org/#concept-tree-inclusive-ancestor
2050 */
2051 void ClearClosestCommonInclusiveAncestorForRangeInSelection() {
2052 ClearBoolFlag(NodeIsClosestCommonInclusiveAncestorForRangeInSelection);
2053 }
2054 /**
2055 * https://dom.spec.whatwg.org/#concept-tree-inclusive-ancestor
2056 */
2057 bool IsDescendantOfClosestCommonInclusiveAncestorForRangeInSelection() const {
2058 return GetBoolFlag(
2059 NodeIsDescendantOfClosestCommonInclusiveAncestorForRangeInSelection);
2060 }
2061 /**
2062 * https://dom.spec.whatwg.org/#concept-tree-inclusive-ancestor
2063 */
2064 void SetDescendantOfClosestCommonInclusiveAncestorForRangeInSelection() {
2065 SetBoolFlag(
2066 NodeIsDescendantOfClosestCommonInclusiveAncestorForRangeInSelection);
2067 }
2068 /**
2069 * https://dom.spec.whatwg.org/#concept-tree-inclusive-ancestor
2070 */
2071 void ClearDescendantOfClosestCommonInclusiveAncestorForRangeInSelection() {
2072 ClearBoolFlag(
2073 NodeIsDescendantOfClosestCommonInclusiveAncestorForRangeInSelection);
2074 }
2075
2076 void SetCCMarkedRoot(bool aValue) { SetBoolFlag(NodeIsCCMarkedRoot, aValue); }
2077 bool CCMarkedRoot() const { return GetBoolFlag(NodeIsCCMarkedRoot); }
2078 void SetInCCBlackTree(bool aValue) { SetBoolFlag(NodeIsCCBlackTree, aValue); }
2079 bool InCCBlackTree() const { return GetBoolFlag(NodeIsCCBlackTree); }
2080 void SetIsPurpleRoot(bool aValue) { SetBoolFlag(NodeIsPurpleRoot, aValue); }
2081 bool IsPurpleRoot() const { return GetBoolFlag(NodeIsPurpleRoot); }
2082 bool MayHaveDOMMutationObserver() {
2083 return GetBoolFlag(NodeMayHaveDOMMutationObserver);
2084 }
2085 void SetMayHaveDOMMutationObserver() {
2086 SetBoolFlag(NodeMayHaveDOMMutationObserver, true);
2087 }
2088 bool HasListenerManager() { return HasFlag(NODE_HAS_LISTENERMANAGER); }
2089 bool HasPointerLock() const { return GetBoolFlag(ElementHasPointerLock); }
2090 void SetPointerLock() { SetBoolFlag(ElementHasPointerLock); }
2091 void ClearPointerLock() { ClearBoolFlag(ElementHasPointerLock); }
2092 bool MayHaveAnimations() const { return GetBoolFlag(ElementHasAnimations); }
2093 void SetMayHaveAnimations() { SetBoolFlag(ElementHasAnimations); }
2094 void ClearMayHaveAnimations() { ClearBoolFlag(ElementHasAnimations); }
2095 void SetHasValidDir() { SetBoolFlag(NodeHasValidDirAttribute); }
2096 void ClearHasValidDir() { ClearBoolFlag(NodeHasValidDirAttribute); }
2097 bool HasValidDir() const { return GetBoolFlag(NodeHasValidDirAttribute); }
2098 void SetAncestorHasDirAuto() { SetBoolFlag(NodeAncestorHasDirAuto); }
2099 void ClearAncestorHasDirAuto() { ClearBoolFlag(NodeAncestorHasDirAuto); }
2100 bool AncestorHasDirAuto() const {
2101 return GetBoolFlag(NodeAncestorHasDirAuto);
2102 }
2103 void SetAffectsDirAutoSlot() { SetBoolFlag(NodeAffectsDirAutoSlot); }
2104 void ClearAffectsDirAutoSlot() { ClearBoolFlag(NodeAffectsDirAutoSlot); }
2105
2106 // Set if the node or an ancestor is assigned to a dir=auto slot.
2107 bool AffectsDirAutoSlot() const {
2108 return GetBoolFlag(NodeAffectsDirAutoSlot);
2109 }
2110
2111 // Implemented in nsIContentInlines.h.
2112 inline bool NodeOrAncestorHasDirAuto() const;
2113
2114 void SetParserHasNotified() { SetBoolFlag(ParserHasNotified); };
2115 bool HasParserNotified() { return GetBoolFlag(ParserHasNotified); }
2116
2117 void SetMayBeApzAware() { SetBoolFlag(MayBeApzAware); }
2118 bool NodeMayBeApzAware() const { return GetBoolFlag(MayBeApzAware); }
2119
2120 void SetMayHaveAnonymousChildren() {
2121 SetBoolFlag(ElementMayHaveAnonymousChildren);
2122 }
2123 bool MayHaveAnonymousChildren() const {
2124 return GetBoolFlag(ElementMayHaveAnonymousChildren);
2125 }
2126
2127 void SetHasCustomElementData() { SetBoolFlag(ElementHasCustomElementData); }
2128 bool HasCustomElementData() const {
2129 return GetBoolFlag(ElementHasCustomElementData);
2130 }
2131
2132 void SetElementCreatedFromPrototypeAndHasUnmodifiedL10n() {
2133 SetBoolFlag(ElementCreatedFromPrototypeAndHasUnmodifiedL10n);
2134 }
2135 bool HasElementCreatedFromPrototypeAndHasUnmodifiedL10n() {
2136 return GetBoolFlag(ElementCreatedFromPrototypeAndHasUnmodifiedL10n);
2137 }
2138 void ClearElementCreatedFromPrototypeAndHasUnmodifiedL10n() {
2139 ClearBoolFlag(ElementCreatedFromPrototypeAndHasUnmodifiedL10n);
2140 }
2141
2142 mozilla::dom::ShadowRoot* GetShadowRoot() const;
2143
2144 // Return the shadow root of the node if it is a shadow host and
2145 // it meets the requirements for being a shadow host of a selection.
2146 // For example, <details>, <video> and <use> elements are not valid
2147 // shadow host for selection.
2148 mozilla::dom::ShadowRoot* GetShadowRootForSelection() const;
2149
2150 protected:
2151 void SetParentIsContent(bool aValue) { SetBoolFlag(ParentIsContent, aValue); }
2152 void SetIsInDocument() { SetBoolFlag(IsInDocument); }
2153 void ClearInDocument() { ClearBoolFlag(IsInDocument); }
2154 void SetIsConnected(bool aConnected) { SetBoolFlag(IsConnected, aConnected); }
2155 void SetNodeIsContent() { SetBoolFlag(NodeIsContent); }
2156 void SetIsElement() { SetBoolFlag(NodeIsElement); }
2157 void SetHasID() { SetBoolFlag(ElementHasID); }
2158 void ClearHasID() { ClearBoolFlag(ElementHasID); }
2159 void SetMayHaveStyle() { SetBoolFlag(ElementMayHaveStyle); }
2160 void SetHasName() { SetBoolFlag(ElementHasName); }
2161 void ClearHasName() { ClearBoolFlag(ElementHasName); }
2162 void SetHasPartAttribute(bool aPart) { SetBoolFlag(ElementHasPart, aPart); }
2163 void SetMayHaveContentEditableAttr() {
2164 SetBoolFlag(ElementMayHaveContentEditableAttr);
2165 }
2166 void SetHasLockedStyleStates() { SetBoolFlag(ElementHasLockedStyleStates); }
2167 void ClearHasLockedStyleStates() {
2168 ClearBoolFlag(ElementHasLockedStyleStates);
2169 }
2170 bool HasLockedStyleStates() const {
2171 return GetBoolFlag(ElementHasLockedStyleStates);
2172 }
2173 void SetHasWeirdParserInsertionMode() {
2174 SetBoolFlag(ElementHasWeirdParserInsertionMode);
2175 }
2176 bool HasWeirdParserInsertionMode() const {
2177 return GetBoolFlag(ElementHasWeirdParserInsertionMode);
2178 }
2179 bool HandlingClick() const { return GetBoolFlag(NodeHandlingClick); }
2180 void SetHandlingClick() { SetBoolFlag(NodeHandlingClick); }
2181 void ClearHandlingClick() { ClearBoolFlag(NodeHandlingClick); }
2182
2183 void SetSubtreeRootPointer(nsINode* aSubtreeRoot) {
2184 NS_ASSERTION(aSubtreeRoot, "aSubtreeRoot can never be null!")do { if (!(aSubtreeRoot)) { NS_DebugBreak(NS_DEBUG_ASSERTION,
"aSubtreeRoot can never be null!", "aSubtreeRoot", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 2184); MOZ_PretendNoReturn(); } } while (0)
;
2185 NS_ASSERTION(!(IsContent() && IsInUncomposedDoc()) && !IsInShadowTree(),do { if (!(!(IsContent() && IsInUncomposedDoc()) &&
!IsInShadowTree())) { NS_DebugBreak(NS_DEBUG_ASSERTION, "Shouldn't be here!"
, "!(IsContent() && IsInUncomposedDoc()) && !IsInShadowTree()"
, "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 2186); MOZ_PretendNoReturn(); } } while (0)
2186 "Shouldn't be here!")do { if (!(!(IsContent() && IsInUncomposedDoc()) &&
!IsInShadowTree())) { NS_DebugBreak(NS_DEBUG_ASSERTION, "Shouldn't be here!"
, "!(IsContent() && IsInUncomposedDoc()) && !IsInShadowTree()"
, "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 2186); MOZ_PretendNoReturn(); } } while (0)
;
2187 mSubtreeRoot = aSubtreeRoot;
2188 }
2189
2190 void ClearSubtreeRootPointer() { mSubtreeRoot = nullptr; }
2191
2192 public:
2193 // Makes nsINode object keep aObject alive. If a callback is provided, it's
2194 // called before deleting the node.
2195 void BindObject(nsISupports* aObject, UnbindCallback = nullptr);
2196 // After calling UnbindObject nsINode, object doesn't keep aObject alive
2197 // anymore.
2198 void UnbindObject(nsISupports* aObject);
2199
2200 void GenerateXPath(nsAString& aResult);
2201
2202 already_AddRefed<mozilla::dom::AccessibleNode> GetAccessibleNode();
2203
2204 /**
2205 * Returns the length of this node, as specified at
2206 * <http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-node-length>
2207 */
2208 uint32_t Length() const;
2209
2210 void GetNodeName(mozilla::dom::DOMString& aNodeName) {
2211 const nsString& nodeName = NodeName();
2212 aNodeName.SetKnownLiveString(nodeName);
2213 }
2214 [[nodiscard]] nsresult GetBaseURI(nsAString& aBaseURI) const;
2215 // Return the base URI for the document.
2216 // The returned value may differ if the document is loaded via XHR, and
2217 // when accessed from chrome privileged script and
2218 // from content privileged script for compatibility.
2219 void GetBaseURIFromJS(nsAString& aBaseURI, CallerType aCallerType,
2220 ErrorResult& aRv) const;
2221 bool HasChildNodes() const { return HasChildren(); }
2222
2223 // See nsContentUtils::PositionIsBefore for aThisIndex and aOtherIndex usage.
2224 uint16_t CompareDocumentPosition(
2225 nsINode& aOther, mozilla::Maybe<uint32_t>* aThisIndex = nullptr,
2226 mozilla::Maybe<uint32_t>* aOtherIndex = nullptr) const;
2227 void GetNodeValue(nsAString& aNodeValue) { GetNodeValueInternal(aNodeValue); }
2228 void SetNodeValue(const nsAString& aNodeValue, mozilla::ErrorResult& aError) {
2229 SetNodeValueInternal(aNodeValue, aError);
2230 }
2231 virtual void GetNodeValueInternal(nsAString& aNodeValue);
2232 virtual void SetNodeValueInternal(const nsAString& aNodeValue,
2233 mozilla::ErrorResult& aError) {
2234 // The DOM spec says that when nodeValue is defined to be null "setting it
2235 // has no effect", so we don't throw an exception.
2236 }
2237 void EnsurePreInsertionValidity(nsINode& aNewChild, nsINode* aRefChild,
2238 mozilla::ErrorResult& aError);
2239 nsINode* InsertBefore(nsINode& aNode, nsINode* aChild,
2240 mozilla::ErrorResult& aError) {
2241 return ReplaceOrInsertBefore(false, &aNode, aChild, aError);
2242 }
2243
2244 /**
2245 * See <https://dom.spec.whatwg.org/#dom-node-appendchild>.
2246 */
2247 nsINode* AppendChild(nsINode& aNode, mozilla::ErrorResult& aError) {
2248 return InsertBefore(aNode, nullptr, aError);
2249 }
2250
2251 nsINode* ReplaceChild(nsINode& aNode, nsINode& aChild,
2252 mozilla::ErrorResult& aError) {
2253 return ReplaceOrInsertBefore(true, &aNode, &aChild, aError);
2254 }
2255 // TODO: Convert this to MOZ_CAN_RUN_SCRIPT (bug 1415230)
2256 MOZ_CAN_RUN_SCRIPT_BOUNDARY nsINode* RemoveChild(
2257 nsINode& aChild, mozilla::ErrorResult& aError);
2258 already_AddRefed<nsINode> CloneNode(bool aDeep, mozilla::ErrorResult& aError);
2259 bool IsSameNode(nsINode* aNode);
2260 bool IsEqualNode(nsINode* aNode);
2261 void GetNamespaceURI(nsAString& aNamespaceURI) const {
2262 mNodeInfo->GetNamespaceURI(aNamespaceURI);
2263 }
2264#ifdef MOZILLA_INTERNAL_API1
2265 void GetPrefix(nsAString& aPrefix) { mNodeInfo->GetPrefix(aPrefix); }
2266#endif
2267 void GetLocalName(mozilla::dom::DOMString& aLocalName) const {
2268 const nsString& localName = LocalName();
2269 aLocalName.SetKnownLiveString(localName);
2270 }
2271
2272 nsDOMAttributeMap* GetAttributes();
2273
2274 // Helper method to remove this node from its parent. This is not exposed
2275 // through WebIDL.
2276 // Only call this if the node has a parent node.
2277 nsresult RemoveFromParent() {
2278 nsINode* parent = GetParentNode();
2279 mozilla::ErrorResult rv;
2280 parent->RemoveChild(*this, rv);
2281 return rv.StealNSResult();
2282 }
2283
2284 // ChildNode methods
2285 inline mozilla::dom::Element* GetPreviousElementSibling() const;
2286 inline mozilla::dom::Element* GetNextElementSibling() const;
2287
2288 MOZ_CAN_RUN_SCRIPT void Before(const Sequence<OwningNodeOrString>& aNodes,
2289 ErrorResult& aRv);
2290 MOZ_CAN_RUN_SCRIPT void After(const Sequence<OwningNodeOrString>& aNodes,
2291 ErrorResult& aRv);
2292 MOZ_CAN_RUN_SCRIPT void ReplaceWith(
2293 const Sequence<OwningNodeOrString>& aNodes, ErrorResult& aRv);
2294 /**
2295 * Remove this node from its parent, if any.
2296 */
2297 void Remove();
2298
2299 // ParentNode methods
2300 mozilla::dom::Element* GetFirstElementChild() const;
2301 mozilla::dom::Element* GetLastElementChild() const;
2302
2303 already_AddRefed<nsIHTMLCollection> GetElementsByAttribute(
2304 const nsAString& aAttribute, const nsAString& aValue);
2305 already_AddRefed<nsIHTMLCollection> GetElementsByAttributeNS(
2306 const nsAString& aNamespaceURI, const nsAString& aAttribute,
2307 const nsAString& aValue, ErrorResult& aRv);
2308
2309 MOZ_CAN_RUN_SCRIPT void Prepend(const Sequence<OwningNodeOrString>& aNodes,
2310 ErrorResult& aRv);
2311 MOZ_CAN_RUN_SCRIPT void Append(const Sequence<OwningNodeOrString>& aNodes,
2312 ErrorResult& aRv);
2313 MOZ_CAN_RUN_SCRIPT void ReplaceChildren(
2314 const Sequence<OwningNodeOrString>& aNodes, ErrorResult& aRv);
2315 MOZ_CAN_RUN_SCRIPT void ReplaceChildren(nsINode* aNode, ErrorResult& aRv);
2316
2317 void GetBoxQuads(const BoxQuadOptions& aOptions,
2318 nsTArray<RefPtr<DOMQuad>>& aResult, CallerType aCallerType,
2319 ErrorResult& aRv);
2320
2321 void GetBoxQuadsFromWindowOrigin(const BoxQuadOptions& aOptions,
2322 nsTArray<RefPtr<DOMQuad>>& aResult,
2323 ErrorResult& aRv);
2324
2325 already_AddRefed<DOMQuad> ConvertQuadFromNode(
2326 DOMQuad& aQuad, const TextOrElementOrDocument& aFrom,
2327 const ConvertCoordinateOptions& aOptions, CallerType aCallerType,
2328 ErrorResult& aRv);
2329 already_AddRefed<DOMQuad> ConvertRectFromNode(
2330 DOMRectReadOnly& aRect, const TextOrElementOrDocument& aFrom,
2331 const ConvertCoordinateOptions& aOptions, CallerType aCallerType,
2332 ErrorResult& aRv);
2333 already_AddRefed<DOMPoint> ConvertPointFromNode(
2334 const DOMPointInit& aPoint, const TextOrElementOrDocument& aFrom,
2335 const ConvertCoordinateOptions& aOptions, CallerType aCallerType,
2336 ErrorResult& aRv);
2337
2338 /**
2339 * See nsSlots::mClosestCommonInclusiveAncestorRanges.
2340 */
2341 const mozilla::LinkedList<mozilla::dom::AbstractRange>*
2342 GetExistingClosestCommonInclusiveAncestorRanges() const {
2343 if (!HasSlots()) {
2344 return nullptr;
2345 }
2346 return GetExistingSlots()->mClosestCommonInclusiveAncestorRanges.get();
2347 }
2348
2349 /**
2350 * See nsSlots::mClosestCommonInclusiveAncestorRanges.
2351 */
2352 mozilla::LinkedList<mozilla::dom::AbstractRange>*
2353 GetExistingClosestCommonInclusiveAncestorRanges() {
2354 if (!HasSlots()) {
2355 return nullptr;
2356 }
2357 return GetExistingSlots()->mClosestCommonInclusiveAncestorRanges.get();
2358 }
2359
2360 /**
2361 * See nsSlots::mClosestCommonInclusiveAncestorRanges.
2362 */
2363 mozilla::UniquePtr<mozilla::LinkedList<mozilla::dom::AbstractRange>>&
2364 GetClosestCommonInclusiveAncestorRangesPtr() {
2365 return Slots()->mClosestCommonInclusiveAncestorRanges;
2366 }
2367
2368 nsIWeakReference* GetExistingWeakReference() {
2369 return HasSlots() ? GetExistingSlots()->mWeakReference : nullptr;
2370 }
2371
2372 protected:
2373 // Override this function to create a custom slots class.
2374 // Must not return null.
2375 virtual nsINode::nsSlots* CreateSlots();
2376
2377 bool HasSlots() const { return mSlots != nullptr; }
2378
2379 nsSlots* GetExistingSlots() const { return mSlots; }
2380
2381 nsSlots* Slots() {
2382 if (!HasSlots()) {
2383 mSlots = CreateSlots();
2384 MOZ_ASSERT(mSlots)do { static_assert( mozilla::detail::AssertionConditionType<
decltype(mSlots)>::isValid, "invalid assertion condition")
; if ((__builtin_expect(!!(!(!!(mSlots))), 0))) { do { } while
(false); MOZ_ReportAssertionFailure("mSlots", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 2384); AnnotateMozCrashReason("MOZ_ASSERT" "(" "mSlots" ")"
); do { *((volatile int*)__null) = 2384; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
2385 }
2386 return GetExistingSlots();
2387 }
2388
2389 /**
2390 * Invalidate cached child array inside mChildNodes
2391 * of type nsParentNodeChildContentList.
2392 */
2393 void InvalidateChildNodes();
2394
2395 virtual void GetTextContentInternal(nsAString& aTextContent,
2396 mozilla::OOMReporter& aError);
2397 virtual void SetTextContentInternal(const nsAString& aTextContent,
2398 nsIPrincipal* aSubjectPrincipal,
2399 mozilla::ErrorResult& aError) {}
2400
2401 void EnsurePreInsertionValidity1(mozilla::ErrorResult& aError);
2402 void EnsurePreInsertionValidity2(bool aReplace, nsINode& aNewChild,
2403 nsINode* aRefChild,
2404 mozilla::ErrorResult& aError);
2405 // TODO: Convert this to MOZ_CAN_RUN_SCRIPT (bug 1415230)
2406 MOZ_CAN_RUN_SCRIPT_BOUNDARY nsINode* ReplaceOrInsertBefore(
2407 bool aReplace, nsINode* aNewChild, nsINode* aRefChild,
2408 mozilla::ErrorResult& aError);
2409
2410 /**
2411 * Returns the Element that should be used for resolving namespaces
2412 * on this node (ie the ownerElement for attributes, the documentElement for
2413 * documents, the node itself for elements and for other nodes the parentNode
2414 * if it is an element).
2415 */
2416 virtual mozilla::dom::Element* GetNameSpaceElement() = 0;
2417
2418 /**
2419 * Parse the given selector string into a servo SelectorList.
2420 *
2421 * Never returns null if aRv is not failing.
2422 *
2423 * Note that the selector list returned here is owned by the owner doc's
2424 * selector cache.
2425 */
2426 const mozilla::StyleSelectorList* ParseSelectorList(
2427 const nsACString& aSelectorString, mozilla::ErrorResult&);
2428
2429 public:
2430 /* Event stuff that documents and elements share.
2431
2432 Note that we include DOCUMENT_ONLY_EVENT events here so that we
2433 can forward all the document stuff to this implementation.
2434 */
2435#define EVENT(name_, id_, type_, struct_) \
2436 mozilla::dom::EventHandlerNonNull* GetOn##name_() { \
2437 return GetEventHandler(nsGkAtoms::on##name_); \
2438 } \
2439 void SetOn##name_(mozilla::dom::EventHandlerNonNull* handler) { \
2440 SetEventHandler(nsGkAtoms::on##name_, handler); \
2441 }
2442#define TOUCH_EVENT EVENT
2443#define DOCUMENT_ONLY_EVENT EVENT
2444#include "mozilla/EventNameList.h"
2445#undef DOCUMENT_ONLY_EVENT
2446#undef TOUCH_EVENT
2447#undef EVENT
2448
2449 NodeSelectorFlags GetSelectorFlags() const {
2450 return static_cast<NodeSelectorFlags>(mSelectorFlags.Get());
2451 }
2452
2453 protected:
2454 static bool Traverse(nsINode* tmp, nsCycleCollectionTraversalCallback& cb);
2455 static void Unlink(nsINode* tmp);
2456
2457 RefPtr<mozilla::dom::NodeInfo> mNodeInfo;
2458
2459 // mParent is an owning ref most of the time, except for the case of document
2460 // nodes, so it cannot be represented by nsCOMPtr, so mark is as
2461 // MOZ_OWNING_REF.
2462 nsINode* MOZ_OWNING_REF mParent;
2463
2464 private:
2465#ifndef BOOL_FLAGS_ON_WRAPPER_CACHE
2466 // Boolean flags.
2467 uint32_t mBoolFlags;
2468#endif
2469
2470 mozilla::RustCell<uint32_t> mSelectorFlags{0};
2471
2472 uint32_t mChildCount;
2473
2474 protected:
2475 // mNextSibling and mFirstChild are strong references while
2476 // mPreviousOrLastSibling is a weak ref. |mFirstChild->mPreviousOrLastSibling|
2477 // points to the last child node.
2478 nsCOMPtr<nsIContent> mFirstChild;
2479 nsCOMPtr<nsIContent> mNextSibling;
2480 nsIContent* MOZ_NON_OWNING_REF mPreviousOrLastSibling;
2481
2482 union {
2483 // Pointer to our primary frame. Might be null.
2484 nsIFrame* mPrimaryFrame;
2485
2486 // Pointer to the root of our subtree. Might be null.
2487 // This reference is non-owning and safe, since it either points to the
2488 // object itself, or is reset by ClearSubtreeRootPointer.
2489 nsINode* MOZ_NON_OWNING_REF mSubtreeRoot;
2490 };
2491
2492 // Storage for more members that are usually not needed; allocated lazily.
2493 nsSlots* mSlots;
2494};
2495
2496NON_VIRTUAL_ADDREF_RELEASE(nsINode)
2497
2498inline nsINode* mozilla::dom::EventTarget::GetAsNode() {
2499 return IsNode() ? AsNode() : nullptr;
2500}
2501
2502inline const nsINode* mozilla::dom::EventTarget::GetAsNode() const {
2503 return const_cast<mozilla::dom::EventTarget*>(this)->GetAsNode();
2504}
2505
2506inline nsINode* mozilla::dom::EventTarget::AsNode() {
2507 MOZ_DIAGNOSTIC_ASSERT(IsNode())do { static_assert( mozilla::detail::AssertionConditionType<
decltype(IsNode())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(IsNode()))), 0))) { do { } while
(false); MOZ_ReportAssertionFailure("IsNode()", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 2507); AnnotateMozCrashReason("MOZ_DIAGNOSTIC_ASSERT" "(" "IsNode()"
")"); do { *((volatile int*)__null) = 2507; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
2508 return static_cast<nsINode*>(this);
2509}
2510
2511inline const nsINode* mozilla::dom::EventTarget::AsNode() const {
2512 MOZ_DIAGNOSTIC_ASSERT(IsNode())do { static_assert( mozilla::detail::AssertionConditionType<
decltype(IsNode())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(IsNode()))), 0))) { do { } while
(false); MOZ_ReportAssertionFailure("IsNode()", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nsINode.h"
, 2512); AnnotateMozCrashReason("MOZ_DIAGNOSTIC_ASSERT" "(" "IsNode()"
")"); do { *((volatile int*)__null) = 2512; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
2513 return static_cast<const nsINode*>(this);
2514}
2515
2516// Useful inline function for getting a node given an nsIContent and a Document.
2517// Returns the first argument cast to nsINode if it is non-null, otherwise
2518// returns the second (which may be null). We use type variables instead of
2519// nsIContent* and Document* because the actual types must be
2520// known for the cast to work.
2521template <class C, class D>
2522inline nsINode* NODE_FROM(C& aContent, D& aDocument) {
2523 if (aContent) return static_cast<nsINode*>(aContent);
2524 return static_cast<nsINode*>(aDocument);
2525}
2526
2527NS_DEFINE_STATIC_IID_ACCESSOR(nsINode, NS_INODE_IID)template <typename T> struct nsINode::COMTypeInfo<nsINode
, T> { static const nsIID kIID __attribute__((visibility("hidden"
))); }; template <typename T> const nsIID nsINode::COMTypeInfo
<nsINode, T>::kIID __attribute__((visibility("hidden"))
) = { 0x70ba4547, 0x7699, 0x44fc, { 0xb3, 0x20, 0x52, 0xdb, 0xe3
, 0xd1, 0xf9, 0x0a } };
2528
2529inline nsISupports* ToSupports(nsINode* aPointer) { return aPointer; }
2530
2531// Some checks are faster to do on nsIContent or Element than on
2532// nsINode, so spit out FromNode versions taking those types too.
2533#define NS_IMPL_FROMNODE_GENERIC(_class, _check, _const)template <typename T> static auto FromNode( _const T&
aNode) -> decltype(static_cast<_const _class*>(&
aNode)) { return aNode._check ? static_cast<_const _class*
>(&aNode) : nullptr; } template <typename T> static
_const _class* FromNode(_const T* aNode) { return FromNode(*
aNode); } template <typename T> static _const _class* FromNodeOrNull
(_const T* aNode) { return aNode ? FromNode(*aNode) : nullptr
; } template <typename T> static auto FromEventTarget(_const
T& aEventTarget) -> decltype(static_cast<_const _class
*>(&aEventTarget)) { return aEventTarget.IsNode() &&
aEventTarget.AsNode()->_check ? static_cast<_const _class
*>(&aEventTarget) : nullptr; } template <typename T
> static _const _class* FromEventTarget(_const T* aEventTarget
) { return FromEventTarget(*aEventTarget); } template <typename
T> static _const _class* FromEventTargetOrNull(_const T* aEventTarget
) { return aEventTarget ? FromEventTarget(*aEventTarget) : nullptr
; }
\
2534 template <typename T> \
2535 static auto FromNode( \
2536 _const T& aNode) -> decltype(static_cast<_const _class*>(&aNode)) { \
2537 return aNode._check ? static_cast<_const _class*>(&aNode) : nullptr; \
2538 } \
2539 template <typename T> \
2540 static _const _class* FromNode(_const T* aNode) { \
2541 return FromNode(*aNode); \
2542 } \
2543 template <typename T> \
2544 static _const _class* FromNodeOrNull(_const T* aNode) { \
2545 return aNode ? FromNode(*aNode) : nullptr; \
2546 } \
2547 template <typename T> \
2548 static auto FromEventTarget(_const T& aEventTarget) \
2549 -> decltype(static_cast<_const _class*>(&aEventTarget)) { \
2550 return aEventTarget.IsNode() && aEventTarget.AsNode()->_check \
2551 ? static_cast<_const _class*>(&aEventTarget) \
2552 : nullptr; \
2553 } \
2554 template <typename T> \
2555 static _const _class* FromEventTarget(_const T* aEventTarget) { \
2556 return FromEventTarget(*aEventTarget); \
2557 } \
2558 template <typename T> \
2559 static _const _class* FromEventTargetOrNull(_const T* aEventTarget) { \
2560 return aEventTarget ? FromEventTarget(*aEventTarget) : nullptr; \
2561 }
2562
2563#define NS_IMPL_FROMNODE_HELPER(_class, _check)template <typename T> static auto FromNode( T& aNode
) -> decltype(static_cast< _class*>(&aNode)) { return
aNode._check ? static_cast< _class*>(&aNode) : nullptr
; } template <typename T> static _class* FromNode( T* aNode
) { return FromNode(*aNode); } template <typename T> static
_class* FromNodeOrNull( T* aNode) { return aNode ? FromNode(
*aNode) : nullptr; } template <typename T> static auto FromEventTarget
( T& aEventTarget) -> decltype(static_cast< _class*
>(&aEventTarget)) { return aEventTarget.IsNode() &&
aEventTarget.AsNode()->_check ? static_cast< _class*>
(&aEventTarget) : nullptr; } template <typename T> static
_class* FromEventTarget( T* aEventTarget) { return FromEventTarget
(*aEventTarget); } template <typename T> static _class*
FromEventTargetOrNull( T* aEventTarget) { return aEventTarget
? FromEventTarget(*aEventTarget) : nullptr; } template <typename
T> static auto FromNode( const T& aNode) -> decltype
(static_cast<const _class*>(&aNode)) { return aNode
._check ? static_cast<const _class*>(&aNode) : nullptr
; } template <typename T> static const _class* FromNode
(const T* aNode) { return FromNode(*aNode); } template <typename
T> static const _class* FromNodeOrNull(const T* aNode) { return
aNode ? FromNode(*aNode) : nullptr; } template <typename T
> static auto FromEventTarget(const T& aEventTarget) ->
decltype(static_cast<const _class*>(&aEventTarget)
) { return aEventTarget.IsNode() && aEventTarget.AsNode
()->_check ? static_cast<const _class*>(&aEventTarget
) : nullptr; } template <typename T> static const _class
* FromEventTarget(const T* aEventTarget) { return FromEventTarget
(*aEventTarget); } template <typename T> static const _class
* FromEventTargetOrNull(const T* aEventTarget) { return aEventTarget
? FromEventTarget(*aEventTarget) : nullptr; } template <typename
T> static _class* FromNode(T&& aNode) { return aNode
->_check ? static_cast<_class*>(static_cast<nsINode
*>(aNode)) : nullptr; } template <typename T> static
_class* FromNodeOrNull(T&& aNode) { return aNode ? FromNode
(aNode) : nullptr; } template <typename T> static _class
* FromEventTarget(T&& aEventTarget) { return aEventTarget
->IsNode() && aEventTarget->AsNode()->_check
? static_cast<_class*>(static_cast<EventTarget*>
(aEventTarget)) : nullptr; } template <typename T> static
_class* FromEventTargetOrNull(T&& aEventTarget) { return
aEventTarget ? FromEventTarget(aEventTarget) : nullptr; }
\
2564 NS_IMPL_FROMNODE_GENERIC(_class, _check, )template <typename T> static auto FromNode( T& aNode
) -> decltype(static_cast< _class*>(&aNode)) { return
aNode._check ? static_cast< _class*>(&aNode) : nullptr
; } template <typename T> static _class* FromNode( T* aNode
) { return FromNode(*aNode); } template <typename T> static
_class* FromNodeOrNull( T* aNode) { return aNode ? FromNode(
*aNode) : nullptr; } template <typename T> static auto FromEventTarget
( T& aEventTarget) -> decltype(static_cast< _class*
>(&aEventTarget)) { return aEventTarget.IsNode() &&
aEventTarget.AsNode()->_check ? static_cast< _class*>
(&aEventTarget) : nullptr; } template <typename T> static
_class* FromEventTarget( T* aEventTarget) { return FromEventTarget
(*aEventTarget); } template <typename T> static _class*
FromEventTargetOrNull( T* aEventTarget) { return aEventTarget
? FromEventTarget(*aEventTarget) : nullptr; }
\
2565 NS_IMPL_FROMNODE_GENERIC(_class, _check, const)template <typename T> static auto FromNode( const T&
aNode) -> decltype(static_cast<const _class*>(&
aNode)) { return aNode._check ? static_cast<const _class*>
(&aNode) : nullptr; } template <typename T> static const
_class* FromNode(const T* aNode) { return FromNode(*aNode); }
template <typename T> static const _class* FromNodeOrNull
(const T* aNode) { return aNode ? FromNode(*aNode) : nullptr;
} template <typename T> static auto FromEventTarget(const
T& aEventTarget) -> decltype(static_cast<const _class
*>(&aEventTarget)) { return aEventTarget.IsNode() &&
aEventTarget.AsNode()->_check ? static_cast<const _class
*>(&aEventTarget) : nullptr; } template <typename T
> static const _class* FromEventTarget(const T* aEventTarget
) { return FromEventTarget(*aEventTarget); } template <typename
T> static const _class* FromEventTargetOrNull(const T* aEventTarget
) { return aEventTarget ? FromEventTarget(*aEventTarget) : nullptr
; }
\
2566 \
2567 template <typename T> \
2568 static _class* FromNode(T&& aNode) { \
2569 /* We need the double-cast in case aNode is a smartptr. Those */ \
2570 /* can cast to superclasses of the type they're templated on, */ \
2571 /* but not directly to subclasses. */ \
2572 return aNode->_check ? static_cast<_class*>(static_cast<nsINode*>(aNode)) \
2573 : nullptr; \
2574 } \
2575 template <typename T> \
2576 static _class* FromNodeOrNull(T&& aNode) { \
2577 return aNode ? FromNode(aNode) : nullptr; \
2578 } \
2579 template <typename T> \
2580 static _class* FromEventTarget(T&& aEventTarget) { \
2581 /* We need the double-cast in case aEventTarget is a smartptr. Those */ \
2582 /* can cast to superclasses of the type they're templated on, */ \
2583 /* but not directly to subclasses. */ \
2584 return aEventTarget->IsNode() && aEventTarget->AsNode()->_check \
2585 ? static_cast<_class*>(static_cast<EventTarget*>(aEventTarget)) \
2586 : nullptr; \
2587 } \
2588 template <typename T> \
2589 static _class* FromEventTargetOrNull(T&& aEventTarget) { \
2590 return aEventTarget ? FromEventTarget(aEventTarget) : nullptr; \
2591 }
2592
2593#define NS_IMPL_FROMNODE(_class, _nsid)template <typename T> static auto FromNode( T& aNode
) -> decltype(static_cast< _class*>(&aNode)) { return
aNode.IsInNamespace(_nsid) ? static_cast< _class*>(&
aNode) : nullptr; } template <typename T> static _class
* FromNode( T* aNode) { return FromNode(*aNode); } template <
typename T> static _class* FromNodeOrNull( T* aNode) { return
aNode ? FromNode(*aNode) : nullptr; } template <typename T
> static auto FromEventTarget( T& aEventTarget) -> decltype
(static_cast< _class*>(&aEventTarget)) { return aEventTarget
.IsNode() && aEventTarget.AsNode()->IsInNamespace(
_nsid) ? static_cast< _class*>(&aEventTarget) : nullptr
; } template <typename T> static _class* FromEventTarget
( T* aEventTarget) { return FromEventTarget(*aEventTarget); }
template <typename T> static _class* FromEventTargetOrNull
( T* aEventTarget) { return aEventTarget ? FromEventTarget(*aEventTarget
) : nullptr; } template <typename T> static auto FromNode
( const T& aNode) -> decltype(static_cast<const _class
*>(&aNode)) { return aNode.IsInNamespace(_nsid) ? static_cast
<const _class*>(&aNode) : nullptr; } template <typename
T> static const _class* FromNode(const T* aNode) { return
FromNode(*aNode); } template <typename T> static const
_class* FromNodeOrNull(const T* aNode) { return aNode ? FromNode
(*aNode) : nullptr; } template <typename T> static auto
FromEventTarget(const T& aEventTarget) -> decltype(static_cast
<const _class*>(&aEventTarget)) { return aEventTarget
.IsNode() && aEventTarget.AsNode()->IsInNamespace(
_nsid) ? static_cast<const _class*>(&aEventTarget) :
nullptr; } template <typename T> static const _class* FromEventTarget
(const T* aEventTarget) { return FromEventTarget(*aEventTarget
); } template <typename T> static const _class* FromEventTargetOrNull
(const T* aEventTarget) { return aEventTarget ? FromEventTarget
(*aEventTarget) : nullptr; } template <typename T> static
_class* FromNode(T&& aNode) { return aNode->IsInNamespace
(_nsid) ? static_cast<_class*>(static_cast<nsINode*>
(aNode)) : nullptr; } template <typename T> static _class
* FromNodeOrNull(T&& aNode) { return aNode ? FromNode
(aNode) : nullptr; } template <typename T> static _class
* FromEventTarget(T&& aEventTarget) { return aEventTarget
->IsNode() && aEventTarget->AsNode()->IsInNamespace
(_nsid) ? static_cast<_class*>(static_cast<EventTarget
*>(aEventTarget)) : nullptr; } template <typename T>
static _class* FromEventTargetOrNull(T&& aEventTarget
) { return aEventTarget ? FromEventTarget(aEventTarget) : nullptr
; }
\
2594 NS_IMPL_FROMNODE_HELPER(_class, IsInNamespace(_nsid))template <typename T> static auto FromNode( T& aNode
) -> decltype(static_cast< _class*>(&aNode)) { return
aNode.IsInNamespace(_nsid) ? static_cast< _class*>(&
aNode) : nullptr; } template <typename T> static _class
* FromNode( T* aNode) { return FromNode(*aNode); } template <
typename T> static _class* FromNodeOrNull( T* aNode) { return
aNode ? FromNode(*aNode) : nullptr; } template <typename T
> static auto FromEventTarget( T& aEventTarget) -> decltype
(static_cast< _class*>(&aEventTarget)) { return aEventTarget
.IsNode() && aEventTarget.AsNode()->IsInNamespace(
_nsid) ? static_cast< _class*>(&aEventTarget) : nullptr
; } template <typename T> static _class* FromEventTarget
( T* aEventTarget) { return FromEventTarget(*aEventTarget); }
template <typename T> static _class* FromEventTargetOrNull
( T* aEventTarget) { return aEventTarget ? FromEventTarget(*aEventTarget
) : nullptr; } template <typename T> static auto FromNode
( const T& aNode) -> decltype(static_cast<const _class
*>(&aNode)) { return aNode.IsInNamespace(_nsid) ? static_cast
<const _class*>(&aNode) : nullptr; } template <typename
T> static const _class* FromNode(const T* aNode) { return
FromNode(*aNode); } template <typename T> static const
_class* FromNodeOrNull(const T* aNode) { return aNode ? FromNode
(*aNode) : nullptr; } template <typename T> static auto
FromEventTarget(const T& aEventTarget) -> decltype(static_cast
<const _class*>(&aEventTarget)) { return aEventTarget
.IsNode() && aEventTarget.AsNode()->IsInNamespace(
_nsid) ? static_cast<const _class*>(&aEventTarget) :
nullptr; } template <typename T> static const _class* FromEventTarget
(const T* aEventTarget) { return FromEventTarget(*aEventTarget
); } template <typename T> static const _class* FromEventTargetOrNull
(const T* aEventTarget) { return aEventTarget ? FromEventTarget
(*aEventTarget) : nullptr; } template <typename T> static
_class* FromNode(T&& aNode) { return aNode->IsInNamespace
(_nsid) ? static_cast<_class*>(static_cast<nsINode*>
(aNode)) : nullptr; } template <typename T> static _class
* FromNodeOrNull(T&& aNode) { return aNode ? FromNode
(aNode) : nullptr; } template <typename T> static _class
* FromEventTarget(T&& aEventTarget) { return aEventTarget
->IsNode() && aEventTarget->AsNode()->IsInNamespace
(_nsid) ? static_cast<_class*>(static_cast<EventTarget
*>(aEventTarget)) : nullptr; } template <typename T>
static _class* FromEventTargetOrNull(T&& aEventTarget
) { return aEventTarget ? FromEventTarget(aEventTarget) : nullptr
; }
2595
2596#define NS_IMPL_FROMNODE_WITH_TAG(_class, _nsid, _tag)template <typename T> static auto FromNode( T& aNode
) -> decltype(static_cast< _class*>(&aNode)) { return
aNode.NodeInfo()->Equals(nsGkAtoms::_tag, _nsid) ? static_cast
< _class*>(&aNode) : nullptr; } template <typename
T> static _class* FromNode( T* aNode) { return FromNode(*
aNode); } template <typename T> static _class* FromNodeOrNull
( T* aNode) { return aNode ? FromNode(*aNode) : nullptr; } template
<typename T> static auto FromEventTarget( T& aEventTarget
) -> decltype(static_cast< _class*>(&aEventTarget
)) { return aEventTarget.IsNode() && aEventTarget.AsNode
()->NodeInfo()->Equals(nsGkAtoms::_tag, _nsid) ? static_cast
< _class*>(&aEventTarget) : nullptr; } template <
typename T> static _class* FromEventTarget( T* aEventTarget
) { return FromEventTarget(*aEventTarget); } template <typename
T> static _class* FromEventTargetOrNull( T* aEventTarget)
{ return aEventTarget ? FromEventTarget(*aEventTarget) : nullptr
; } template <typename T> static auto FromNode( const T
& aNode) -> decltype(static_cast<const _class*>(
&aNode)) { return aNode.NodeInfo()->Equals(nsGkAtoms::
_tag, _nsid) ? static_cast<const _class*>(&aNode) :
nullptr; } template <typename T> static const _class* FromNode
(const T* aNode) { return FromNode(*aNode); } template <typename
T> static const _class* FromNodeOrNull(const T* aNode) { return
aNode ? FromNode(*aNode) : nullptr; } template <typename T
> static auto FromEventTarget(const T& aEventTarget) ->
decltype(static_cast<const _class*>(&aEventTarget)
) { return aEventTarget.IsNode() && aEventTarget.AsNode
()->NodeInfo()->Equals(nsGkAtoms::_tag, _nsid) ? static_cast
<const _class*>(&aEventTarget) : nullptr; } template
<typename T> static const _class* FromEventTarget(const
T* aEventTarget) { return FromEventTarget(*aEventTarget); } template
<typename T> static const _class* FromEventTargetOrNull
(const T* aEventTarget) { return aEventTarget ? FromEventTarget
(*aEventTarget) : nullptr; } template <typename T> static
_class* FromNode(T&& aNode) { return aNode->NodeInfo
()->Equals(nsGkAtoms::_tag, _nsid) ? static_cast<_class
*>(static_cast<nsINode*>(aNode)) : nullptr; } template
<typename T> static _class* FromNodeOrNull(T&&
aNode) { return aNode ? FromNode(aNode) : nullptr; } template
<typename T> static _class* FromEventTarget(T&&
aEventTarget) { return aEventTarget->IsNode() && aEventTarget
->AsNode()->NodeInfo()->Equals(nsGkAtoms::_tag, _nsid
) ? static_cast<_class*>(static_cast<EventTarget*>
(aEventTarget)) : nullptr; } template <typename T> static
_class* FromEventTargetOrNull(T&& aEventTarget) { return
aEventTarget ? FromEventTarget(aEventTarget) : nullptr; }
\
2597 NS_IMPL_FROMNODE_HELPER(_class, NodeInfo()->Equals(nsGkAtoms::_tag, _nsid))template <typename T> static auto FromNode( T& aNode
) -> decltype(static_cast< _class*>(&aNode)) { return
aNode.NodeInfo()->Equals(nsGkAtoms::_tag, _nsid) ? static_cast
< _class*>(&aNode) : nullptr; } template <typename
T> static _class* FromNode( T* aNode) { return FromNode(*
aNode); } template <typename T> static _class* FromNodeOrNull
( T* aNode) { return aNode ? FromNode(*aNode) : nullptr; } template
<typename T> static auto FromEventTarget( T& aEventTarget
) -> decltype(static_cast< _class*>(&aEventTarget
)) { return aEventTarget.IsNode() && aEventTarget.AsNode
()->NodeInfo()->Equals(nsGkAtoms::_tag, _nsid) ? static_cast
< _class*>(&aEventTarget) : nullptr; } template <
typename T> static _class* FromEventTarget( T* aEventTarget
) { return FromEventTarget(*aEventTarget); } template <typename
T> static _class* FromEventTargetOrNull( T* aEventTarget)
{ return aEventTarget ? FromEventTarget(*aEventTarget) : nullptr
; } template <typename T> static auto FromNode( const T
& aNode) -> decltype(static_cast<const _class*>(
&aNode)) { return aNode.NodeInfo()->Equals(nsGkAtoms::
_tag, _nsid) ? static_cast<const _class*>(&aNode) :
nullptr; } template <typename T> static const _class* FromNode
(const T* aNode) { return FromNode(*aNode); } template <typename
T> static const _class* FromNodeOrNull(const T* aNode) { return
aNode ? FromNode(*aNode) : nullptr; } template <typename T
> static auto FromEventTarget(const T& aEventTarget) ->
decltype(static_cast<const _class*>(&aEventTarget)
) { return aEventTarget.IsNode() && aEventTarget.AsNode
()->NodeInfo()->Equals(nsGkAtoms::_tag, _nsid) ? static_cast
<const _class*>(&aEventTarget) : nullptr; } template
<typename T> static const _class* FromEventTarget(const
T* aEventTarget) { return FromEventTarget(*aEventTarget); } template
<typename T> static const _class* FromEventTargetOrNull
(const T* aEventTarget) { return aEventTarget ? FromEventTarget
(*aEventTarget) : nullptr; } template <typename T> static
_class* FromNode(T&& aNode) { return aNode->NodeInfo
()->Equals(nsGkAtoms::_tag, _nsid) ? static_cast<_class
*>(static_cast<nsINode*>(aNode)) : nullptr; } template
<typename T> static _class* FromNodeOrNull(T&&
aNode) { return aNode ? FromNode(aNode) : nullptr; } template
<typename T> static _class* FromEventTarget(T&&
aEventTarget) { return aEventTarget->IsNode() && aEventTarget
->AsNode()->NodeInfo()->Equals(nsGkAtoms::_tag, _nsid
) ? static_cast<_class*>(static_cast<EventTarget*>
(aEventTarget)) : nullptr; } template <typename T> static
_class* FromEventTargetOrNull(T&& aEventTarget) { return
aEventTarget ? FromEventTarget(aEventTarget) : nullptr; }
2598
2599#define NS_IMPL_FROMNODE_HTML_WITH_TAG(_class, _tag)template <typename T> static auto FromNode( T& aNode
) -> decltype(static_cast< _class*>(&aNode)) { return
aNode.NodeInfo()->Equals(nsGkAtoms::_tag, 3) ? static_cast
< _class*>(&aNode) : nullptr; } template <typename
T> static _class* FromNode( T* aNode) { return FromNode(*
aNode); } template <typename T> static _class* FromNodeOrNull
( T* aNode) { return aNode ? FromNode(*aNode) : nullptr; } template
<typename T> static auto FromEventTarget( T& aEventTarget
) -> decltype(static_cast< _class*>(&aEventTarget
)) { return aEventTarget.IsNode() && aEventTarget.AsNode
()->NodeInfo()->Equals(nsGkAtoms::_tag, 3) ? static_cast
< _class*>(&aEventTarget) : nullptr; } template <
typename T> static _class* FromEventTarget( T* aEventTarget
) { return FromEventTarget(*aEventTarget); } template <typename
T> static _class* FromEventTargetOrNull( T* aEventTarget)
{ return aEventTarget ? FromEventTarget(*aEventTarget) : nullptr
; } template <typename T> static auto FromNode( const T
& aNode) -> decltype(static_cast<const _class*>(
&aNode)) { return aNode.NodeInfo()->Equals(nsGkAtoms::
_tag, 3) ? static_cast<const _class*>(&aNode) : nullptr
; } template <typename T> static const _class* FromNode
(const T* aNode) { return FromNode(*aNode); } template <typename
T> static const _class* FromNodeOrNull(const T* aNode) { return
aNode ? FromNode(*aNode) : nullptr; } template <typename T
> static auto FromEventTarget(const T& aEventTarget) ->
decltype(static_cast<const _class*>(&aEventTarget)
) { return aEventTarget.IsNode() && aEventTarget.AsNode
()->NodeInfo()->Equals(nsGkAtoms::_tag, 3) ? static_cast
<const _class*>(&aEventTarget) : nullptr; } template
<typename T> static const _class* FromEventTarget(const
T* aEventTarget) { return FromEventTarget(*aEventTarget); } template
<typename T> static const _class* FromEventTargetOrNull
(const T* aEventTarget) { return aEventTarget ? FromEventTarget
(*aEventTarget) : nullptr; } template <typename T> static
_class* FromNode(T&& aNode) { return aNode->NodeInfo
()->Equals(nsGkAtoms::_tag, 3) ? static_cast<_class*>
(static_cast<nsINode*>(aNode)) : nullptr; } template <
typename T> static _class* FromNodeOrNull(T&& aNode
) { return aNode ? FromNode(aNode) : nullptr; } template <
typename T> static _class* FromEventTarget(T&& aEventTarget
) { return aEventTarget->IsNode() && aEventTarget->
AsNode()->NodeInfo()->Equals(nsGkAtoms::_tag, 3) ? static_cast
<_class*>(static_cast<EventTarget*>(aEventTarget)
) : nullptr; } template <typename T> static _class* FromEventTargetOrNull
(T&& aEventTarget) { return aEventTarget ? FromEventTarget
(aEventTarget) : nullptr; }
\
2600 NS_IMPL_FROMNODE_WITH_TAG(_class, kNameSpaceID_XHTML, _tag)template <typename T> static auto FromNode( T& aNode
) -> decltype(static_cast< _class*>(&aNode)) { return
aNode.NodeInfo()->Equals(nsGkAtoms::_tag, 3) ? static_cast
< _class*>(&aNode) : nullptr; } template <typename
T> static _class* FromNode( T* aNode) { return FromNode(*
aNode); } template <typename T> static _class* FromNodeOrNull
( T* aNode) { return aNode ? FromNode(*aNode) : nullptr; } template
<typename T> static auto FromEventTarget( T& aEventTarget
) -> decltype(static_cast< _class*>(&aEventTarget
)) { return aEventTarget.IsNode() && aEventTarget.AsNode
()->NodeInfo()->Equals(nsGkAtoms::_tag, 3) ? static_cast
< _class*>(&aEventTarget) : nullptr; } template <
typename T> static _class* FromEventTarget( T* aEventTarget
) { return FromEventTarget(*aEventTarget); } template <typename
T> static _class* FromEventTargetOrNull( T* aEventTarget)
{ return aEventTarget ? FromEventTarget(*aEventTarget) : nullptr
; } template <typename T> static auto FromNode( const T
& aNode) -> decltype(static_cast<const _class*>(
&aNode)) { return aNode.NodeInfo()->Equals(nsGkAtoms::
_tag, 3) ? static_cast<const _class*>(&aNode) : nullptr
; } template <typename T> static const _class* FromNode
(const T* aNode) { return FromNode(*aNode); } template <typename
T> static const _class* FromNodeOrNull(const T* aNode) { return
aNode ? FromNode(*aNode) : nullptr; } template <typename T
> static auto FromEventTarget(const T& aEventTarget) ->
decltype(static_cast<const _class*>(&aEventTarget)
) { return aEventTarget.IsNode() && aEventTarget.AsNode
()->NodeInfo()->Equals(nsGkAtoms::_tag, 3) ? static_cast
<const _class*>(&aEventTarget) : nullptr; } template
<typename T> static const _class* FromEventTarget(const
T* aEventTarget) { return FromEventTarget(*aEventTarget); } template
<typename T> static const _class* FromEventTargetOrNull
(const T* aEventTarget) { return aEventTarget ? FromEventTarget
(*aEventTarget) : nullptr; } template <typename T> static
_class* FromNode(T&& aNode) { return aNode->NodeInfo
()->Equals(nsGkAtoms::_tag, 3) ? static_cast<_class*>
(static_cast<nsINode*>(aNode)) : nullptr; } template <
typename T> static _class* FromNodeOrNull(T&& aNode
) { return aNode ? FromNode(aNode) : nullptr; } template <
typename T> static _class* FromEventTarget(T&& aEventTarget
) { return aEventTarget->IsNode() && aEventTarget->
AsNode()->NodeInfo()->Equals(nsGkAtoms::_tag, 3) ? static_cast
<_class*>(static_cast<EventTarget*>(aEventTarget)
) : nullptr; } template <typename T> static _class* FromEventTargetOrNull
(T&& aEventTarget) { return aEventTarget ? FromEventTarget
(aEventTarget) : nullptr; }
2601
2602#endif /* nsINode_h___ */

/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/mozilla/Maybe.h

1/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
2/* vim: set ts=8 sts=2 et sw=2 tw=80: */
3/* This Source Code Form is subject to the terms of the Mozilla Public
4 * License, v. 2.0. If a copy of the MPL was not distributed with this
5 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
6
7/* A class for optional values and in-place lazy construction. */
8
9#ifndef mozilla_Maybe_h
10#define mozilla_Maybe_h
11
12#include <functional>
13#include <new> // for placement new
14#include <ostream>
15#include <type_traits>
16#include <utility>
17
18#include "mozilla/Alignment.h"
19#include "mozilla/Assertions.h"
20#include "mozilla/Attributes.h"
21#include "mozilla/MaybeStorageBase.h"
22#include "mozilla/MemoryChecking.h"
23#include "mozilla/OperatorNewExtensions.h"
24#include "mozilla/Poison.h"
25#include "mozilla/ThreadSafety.h"
26
27class nsCycleCollectionTraversalCallback;
28
29template <typename T>
30inline void CycleCollectionNoteChild(
31 nsCycleCollectionTraversalCallback& aCallback, T* aChild, const char* aName,
32 uint32_t aFlags);
33
34namespace mozilla {
35
36struct Nothing {};
37
38inline constexpr bool operator==(const Nothing&, const Nothing&) {
39 return true;
40}
41
42template <class T>
43class Maybe;
44
45namespace detail {
46
47// You would think that poisoning Maybe instances could just be a call
48// to mozWritePoison. Unfortunately, using a simple call to
49// mozWritePoison generates poor code on MSVC for small structures. The
50// generated code contains (always not-taken) branches and does a bunch
51// of setup for `rep stos{l,q}`, even though we know at compile time
52// exactly how many words we're poisoning. Instead, we're going to
53// force MSVC to generate the code we want via recursive templates.
54
55// Write the given poisonValue into p at offset*sizeof(uintptr_t).
56template <size_t offset>
57inline void WritePoisonAtOffset(void* p, const uintptr_t poisonValue) {
58 memcpy(static_cast<char*>(p) + offset * sizeof(poisonValue), &poisonValue,
59 sizeof(poisonValue));
60}
61
62template <size_t Offset, size_t NOffsets>
63struct InlinePoisoner {
64 static void poison(void* p, const uintptr_t poisonValue) {
65 WritePoisonAtOffset<Offset>(p, poisonValue);
66 InlinePoisoner<Offset + 1, NOffsets>::poison(p, poisonValue);
67 }
68};
69
70template <size_t N>
71struct InlinePoisoner<N, N> {
72 static void poison(void*, const uintptr_t) {
73 // All done!
74 }
75};
76
77// We can't generate inline code for large structures, though, because we'll
78// blow out recursive template instantiation limits, and the code would be
79// bloated to boot. So provide a fallback to the out-of-line poisoner.
80template <size_t ObjectSize>
81struct OutOfLinePoisoner {
82 static MOZ_NEVER_INLINE__attribute__((noinline)) void poison(void* p, const uintptr_t) {
83 mozWritePoison(p, ObjectSize);
84 }
85};
86
87template <typename T>
88inline void PoisonObject(T* p) {
89 const uintptr_t POISON = mozPoisonValue();
90 std::conditional_t<(sizeof(T) <= 8 * sizeof(POISON)),
91 InlinePoisoner<0, sizeof(T) / sizeof(POISON)>,
92 OutOfLinePoisoner<sizeof(T)>>::poison(p, POISON);
93}
94
95template <typename T>
96struct MaybePoisoner {
97 static const size_t N = sizeof(T);
98
99 static void poison(void* aPtr) {
100#ifdef MOZ_DIAGNOSTIC_ASSERT_ENABLED1
101 if (N >= sizeof(uintptr_t)) {
102 PoisonObject(static_cast<std::remove_cv_t<T>*>(aPtr));
103 }
104#endif
105 MOZ_MAKE_MEM_UNDEFINED(aPtr, N)do { } while (0);
106 }
107};
108
109template <typename T,
110 bool TriviallyDestructibleAndCopyable =
111 IsTriviallyDestructibleAndCopyable<T>,
112 bool Copyable = std::is_copy_constructible_v<T>,
113 bool Movable = std::is_move_constructible_v<T>>
114class Maybe_CopyMove_Enabler;
115
116#define MOZ_MAYBE_COPY_OPS() \
117 Maybe_CopyMove_Enabler(const Maybe_CopyMove_Enabler& aOther) { \
118 if (downcast(aOther).isSome()) { \
119 downcast(*this).emplace(*downcast(aOther)); \
120 } \
121 } \
122 \
123 Maybe_CopyMove_Enabler& operator=(const Maybe_CopyMove_Enabler& aOther) { \
124 return downcast(*this).template operator= <T>(downcast(aOther)); \
125 }
126
127#define MOZ_MAYBE_MOVE_OPS() \
128 constexpr Maybe_CopyMove_Enabler(Maybe_CopyMove_Enabler&& aOther) { \
129 if (downcast(aOther).isSome()) { \
130 downcast(*this).emplace(std::move(*downcast(aOther))); \
131 downcast(aOther).reset(); \
132 } \
133 } \
134 \
135 constexpr Maybe_CopyMove_Enabler& operator=( \
136 Maybe_CopyMove_Enabler&& aOther) { \
137 downcast(*this).template operator= <T>(std::move(downcast(aOther))); \
138 \
139 return *this; \
140 }
141
142#define MOZ_MAYBE_DOWNCAST() \
143 static constexpr Maybe<T>& downcast(Maybe_CopyMove_Enabler& aObj) { \
144 return static_cast<Maybe<T>&>(aObj); \
145 } \
146 static constexpr const Maybe<T>& downcast( \
147 const Maybe_CopyMove_Enabler& aObj) { \
148 return static_cast<const Maybe<T>&>(aObj); \
149 }
150
151template <typename T>
152class Maybe_CopyMove_Enabler<T, true, true, true> {
153 public:
154 Maybe_CopyMove_Enabler() = default;
155
156 Maybe_CopyMove_Enabler(const Maybe_CopyMove_Enabler&) = default;
157 Maybe_CopyMove_Enabler& operator=(const Maybe_CopyMove_Enabler&) = default;
158 constexpr Maybe_CopyMove_Enabler(Maybe_CopyMove_Enabler&& aOther) {
159 downcast(aOther).reset();
160 }
161 constexpr Maybe_CopyMove_Enabler& operator=(Maybe_CopyMove_Enabler&& aOther) {
162 downcast(aOther).reset();
163 return *this;
164 }
165
166 private:
167 MOZ_MAYBE_DOWNCAST()
168};
169
170template <typename T>
171class Maybe_CopyMove_Enabler<T, true, false, true> {
172 public:
173 Maybe_CopyMove_Enabler() = default;
174
175 Maybe_CopyMove_Enabler(const Maybe_CopyMove_Enabler&) = delete;
176 Maybe_CopyMove_Enabler& operator=(const Maybe_CopyMove_Enabler&) = delete;
177 constexpr Maybe_CopyMove_Enabler(Maybe_CopyMove_Enabler&& aOther) {
178 downcast(aOther).reset();
179 }
180 constexpr Maybe_CopyMove_Enabler& operator=(Maybe_CopyMove_Enabler&& aOther) {
181 downcast(aOther).reset();
182 return *this;
183 }
184
185 private:
186 MOZ_MAYBE_DOWNCAST()
187};
188
189template <typename T>
190class Maybe_CopyMove_Enabler<T, false, true, true> {
191 public:
192 Maybe_CopyMove_Enabler() = default;
193
194 MOZ_MAYBE_COPY_OPS()
195 MOZ_MAYBE_MOVE_OPS()
196
197 private:
198 MOZ_MAYBE_DOWNCAST()
199};
200
201template <typename T>
202class Maybe_CopyMove_Enabler<T, false, false, true> {
203 public:
204 Maybe_CopyMove_Enabler() = default;
205
206 Maybe_CopyMove_Enabler(const Maybe_CopyMove_Enabler&) = delete;
207 Maybe_CopyMove_Enabler& operator=(const Maybe_CopyMove_Enabler&) = delete;
208 MOZ_MAYBE_MOVE_OPS()
209
210 private:
211 MOZ_MAYBE_DOWNCAST()
212};
213
214template <typename T>
215class Maybe_CopyMove_Enabler<T, false, true, false> {
216 public:
217 Maybe_CopyMove_Enabler() = default;
218
219 MOZ_MAYBE_COPY_OPS()
220 Maybe_CopyMove_Enabler(Maybe_CopyMove_Enabler&&) = delete;
221 Maybe_CopyMove_Enabler& operator=(Maybe_CopyMove_Enabler&&) = delete;
222
223 private:
224 MOZ_MAYBE_DOWNCAST()
225};
226
227template <typename T, bool TriviallyDestructibleAndCopyable>
228class Maybe_CopyMove_Enabler<T, TriviallyDestructibleAndCopyable, false,
229 false> {
230 public:
231 Maybe_CopyMove_Enabler() = default;
232
233 Maybe_CopyMove_Enabler(const Maybe_CopyMove_Enabler&) = delete;
234 Maybe_CopyMove_Enabler& operator=(const Maybe_CopyMove_Enabler&) = delete;
235 Maybe_CopyMove_Enabler(Maybe_CopyMove_Enabler&&) = delete;
236 Maybe_CopyMove_Enabler& operator=(Maybe_CopyMove_Enabler&&) = delete;
237};
238
239#undef MOZ_MAYBE_COPY_OPS
240#undef MOZ_MAYBE_MOVE_OPS
241#undef MOZ_MAYBE_DOWNCAST
242
243template <typename T, bool TriviallyDestructibleAndCopyable =
244 IsTriviallyDestructibleAndCopyable<T>>
245struct MaybeStorage;
246
247template <typename T>
248struct MaybeStorage<T, false> : MaybeStorageBase<T> {
249 protected:
250 char mIsSome = false; // not bool -- guarantees minimal space consumption
251
252 MaybeStorage() = default;
253 explicit MaybeStorage(const T& aVal)
254 : MaybeStorageBase<T>{aVal}, mIsSome{true} {}
255 explicit MaybeStorage(T&& aVal)
256 : MaybeStorageBase<T>{std::move(aVal)}, mIsSome{true} {}
257
258 template <typename... Args>
259 explicit MaybeStorage(std::in_place_t, Args&&... aArgs)
260 : MaybeStorageBase<T>{std::in_place, std::forward<Args>(aArgs)...},
261 mIsSome{true} {}
262
263 public:
264 // Copy and move operations are no-ops, since copying is moving is implemented
265 // by Maybe_CopyMove_Enabler.
266
267 MaybeStorage(const MaybeStorage&) : MaybeStorageBase<T>{} {}
268 MaybeStorage& operator=(const MaybeStorage&) { return *this; }
269 MaybeStorage(MaybeStorage&&) : MaybeStorageBase<T>{} {}
270 MaybeStorage& operator=(MaybeStorage&&) { return *this; }
271
272 ~MaybeStorage() {
273 if (mIsSome
9.1
Field 'mIsSome' is 1
9.1
Field 'mIsSome' is 1
9.1
Field 'mIsSome' is 1
9.1
Field 'mIsSome' is 1
9.1
Field 'mIsSome' is 1
) {
10
Taking true branch
274 this->addr()->T::~T();
11
Calling '~ByteBuf'
13
Returning; memory was released
275 }
276 }
14
Calling implicit destructor for 'MaybeStorageBase<mozilla::ipc::ByteBuf, false>'
15
Calling '~Union'
277};
278
279template <typename T>
280struct MaybeStorage<T, true> : MaybeStorageBase<T> {
281 protected:
282 char mIsSome = false; // not bool -- guarantees minimal space consumption
283
284 constexpr MaybeStorage() = default;
285 constexpr explicit MaybeStorage(const T& aVal)
286 : MaybeStorageBase<T>{aVal}, mIsSome{true} {}
287 constexpr explicit MaybeStorage(T&& aVal)
288 : MaybeStorageBase<T>{std::move(aVal)}, mIsSome{true} {}
289
290 template <typename... Args>
291 constexpr explicit MaybeStorage(std::in_place_t, Args&&... aArgs)
292 : MaybeStorageBase<T>{std::in_place, std::forward<Args>(aArgs)...},
293 mIsSome{true} {}
294};
295
296template <typename T>
297struct IsMaybeImpl : std::false_type {};
298
299template <typename T>
300struct IsMaybeImpl<Maybe<T>> : std::true_type {};
301
302template <typename T>
303using IsMaybe = IsMaybeImpl<std::decay_t<T>>;
304
305} // namespace detail
306
307template <typename T, typename U = typename std::remove_cv<
308 typename std::remove_reference<T>::type>::type>
309constexpr Maybe<U> Some(T&& aValue);
310
311/*
312 * Maybe is a container class which contains either zero or one elements. It
313 * serves two roles. It can represent values which are *semantically* optional,
314 * augmenting a type with an explicit 'Nothing' value. In this role, it provides
315 * methods that make it easy to work with values that may be missing, along with
316 * equality and comparison operators so that Maybe values can be stored in
317 * containers. Maybe values can be constructed conveniently in expressions using
318 * type inference, as follows:
319 *
320 * void doSomething(Maybe<Foo> aFoo) {
321 * if (aFoo) // Make sure that aFoo contains a value...
322 * aFoo->takeAction(); // and then use |aFoo->| to access it.
323 * } // |*aFoo| also works!
324 *
325 * doSomething(Nothing()); // Passes a Maybe<Foo> containing no value.
326 * doSomething(Some(Foo(100))); // Passes a Maybe<Foo> containing |Foo(100)|.
327 *
328 * You'll note that it's important to check whether a Maybe contains a value
329 * before using it, using conversion to bool, |isSome()|, or |isNothing()|. You
330 * can avoid these checks, and sometimes write more readable code, using
331 * |valueOr()|, |ptrOr()|, and |refOr()|, which allow you to retrieve the value
332 * in the Maybe and provide a default for the 'Nothing' case. You can also use
333 * |apply()| to call a function only if the Maybe holds a value, and |map()| to
334 * transform the value in the Maybe, returning another Maybe with a possibly
335 * different type.
336 *
337 * Maybe's other role is to support lazily constructing objects without using
338 * dynamic storage. A Maybe directly contains storage for a value, but it's
339 * empty by default. |emplace()|, as mentioned above, can be used to construct a
340 * value in Maybe's storage. The value a Maybe contains can be destroyed by
341 * calling |reset()|; this will happen automatically if a Maybe is destroyed
342 * while holding a value.
343 *
344 * It's a common idiom in C++ to use a pointer as a 'Maybe' type, with a null
345 * value meaning 'Nothing' and any other value meaning 'Some'. You can convert
346 * from such a pointer to a Maybe value using 'ToMaybe()'.
347 *
348 * Maybe is inspired by similar types in the standard library of many other
349 * languages (e.g. Haskell's Maybe and Rust's Option). In the C++ world it's
350 * very similar to std::optional, which was proposed for C++14 and originated in
351 * Boost. The most important differences between Maybe and std::optional are:
352 *
353 * - std::optional<T> may be compared with T. We deliberately forbid that.
354 * - std::optional has |valueOr()|, equivalent to Maybe's |valueOr()|, but
355 * lacks corresponding methods for |refOr()| and |ptrOr()|.
356 * - std::optional lacks |map()| and |apply()|, making it less suitable for
357 * functional-style code.
358 * - std::optional lacks many convenience functions that Maybe has. Most
359 * unfortunately, it lacks equivalents of the type-inferred constructor
360 * functions |Some()| and |Nothing()|.
361 */
362template <class T>
363class MOZ_INHERIT_TYPE_ANNOTATIONS_FROM_TEMPLATE_ARGS Maybe
364 : private detail::MaybeStorage<T>,
365 public detail::Maybe_CopyMove_Enabler<T> {
366 template <typename, bool, bool, bool>
367 friend class detail::Maybe_CopyMove_Enabler;
368
369 template <typename U, typename V>
370 friend constexpr Maybe<V> Some(U&& aValue);
371
372 struct SomeGuard {};
373
374 template <typename U>
375 constexpr Maybe(U&& aValue, SomeGuard)
376 : detail::MaybeStorage<T>{std::forward<U>(aValue)} {}
377
378 using detail::MaybeStorage<T>::mIsSome;
379 using detail::MaybeStorage<T>::mStorage;
380
381 void poisonData() { detail::MaybePoisoner<T>::poison(&mStorage.val); }
382
383 public:
384 using ValueType = T;
385
386 MOZ_ALLOW_TEMPORARY constexpr Maybe() = default;
387
388 MOZ_ALLOW_TEMPORARY MOZ_IMPLICIT constexpr Maybe(Nothing) : Maybe{} {}
389
390 template <typename... Args>
391 constexpr explicit Maybe(std::in_place_t, Args&&... aArgs)
392 : detail::MaybeStorage<T>{std::in_place, std::forward<Args>(aArgs)...} {}
393
394 /**
395 * Maybe<T> can be copy-constructed from a Maybe<U> if T is constructible from
396 * a const U&.
397 */
398 template <typename U,
399 std::enable_if_t<std::is_constructible_v<T, const U&>, bool> = true>
400 MOZ_IMPLICIT Maybe(const Maybe<U>& aOther) {
401 if (aOther.isSome()) {
402 emplace(*aOther);
403 }
404 }
405
406 template <typename U, std::enable_if_t<!std::is_constructible_v<T, const U&>,
407 bool> = true>
408 explicit Maybe(const Maybe<U>& aOther) = delete;
409
410 /**
411 * Maybe<T> can be move-constructed from a Maybe<U> if T is constructible from
412 * a U&&.
413 */
414 template <typename U,
415 std::enable_if_t<std::is_constructible_v<T, U&&>, bool> = true>
416 MOZ_IMPLICIT Maybe(Maybe<U>&& aOther) {
417 if (aOther.isSome()) {
418 emplace(std::move(*aOther));
419 aOther.reset();
420 }
421 }
422 template <typename U,
423 std::enable_if_t<!std::is_constructible_v<T, U&&>, bool> = true>
424 explicit Maybe(Maybe<U>&& aOther) = delete;
425
426 template <typename U,
427 std::enable_if_t<std::is_constructible_v<T, const U&>, bool> = true>
428 Maybe& operator=(const Maybe<U>& aOther) {
429 if (aOther.isSome()) {
430 if (mIsSome) {
431 ref() = aOther.ref();
432 } else {
433 emplace(*aOther);
434 }
435 } else {
436 reset();
437 }
438 return *this;
439 }
440
441 template <typename U, std::enable_if_t<!std::is_constructible_v<T, const U&>,
442 bool> = true>
443 Maybe& operator=(const Maybe<U>& aOther) = delete;
444
445 template <typename U,
446 std::enable_if_t<std::is_constructible_v<T, U&&>, bool> = true>
447 Maybe& operator=(Maybe<U>&& aOther) {
448 if (aOther.isSome()) {
449 if (mIsSome) {
450 ref() = std::move(aOther.ref());
451 } else {
452 emplace(std::move(*aOther));
453 }
454 aOther.reset();
455 } else {
456 reset();
457 }
458
459 return *this;
460 }
461
462 template <typename U,
463 std::enable_if_t<!std::is_constructible_v<T, U&&>, bool> = true>
464 Maybe& operator=(Maybe<U>&& aOther) = delete;
465
466 constexpr Maybe& operator=(Nothing) {
467 reset();
468 return *this;
469 }
470
471 /* Methods that check whether this Maybe contains a value */
472 constexpr explicit operator bool() const { return isSome(); }
473 constexpr bool isSome() const { return mIsSome; }
474 constexpr bool isNothing() const { return !mIsSome; }
475
476 /* Returns the contents of this Maybe<T> by value. Unsafe unless |isSome()|.
477 */
478 constexpr T value() const&;
479 constexpr T value() &&;
480 constexpr T value() const&&;
481
482 /**
483 * Move the contents of this Maybe<T> out of internal storage and return it
484 * without calling the destructor. The internal storage is also reset to
485 * avoid multiple calls. Unsafe unless |isSome()|.
486 */
487 constexpr T extract() {
488 MOZ_RELEASE_ASSERT(isSome())do { static_assert( mozilla::detail::AssertionConditionType<
decltype(isSome())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(isSome()))), 0))) { do { } while
(false); MOZ_ReportAssertionFailure("isSome()", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/mozilla/Maybe.h"
, 488); AnnotateMozCrashReason("MOZ_RELEASE_ASSERT" "(" "isSome()"
")"); do { *((volatile int*)__null) = 488; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
489 T v = std::move(mStorage.val);
490 reset();
491 return v;
492 }
493
494 /**
495 * Returns the value (possibly |Nothing()|) by moving it out of this Maybe<T>
496 * and leaving |Nothing()| in its place.
497 */
498 Maybe<T> take() { return std::exchange(*this, Nothing()); }
499
500 /*
501 * Returns the contents of this Maybe<T> by value. If |isNothing()|, returns
502 * the default value provided.
503 *
504 * Note: If the value passed to aDefault is not the result of a trivial
505 * expression, but expensive to evaluate, e.g. |valueOr(ExpensiveFunction())|,
506 * use |valueOrFrom| instead, e.g.
507 * |valueOrFrom([arg] { return ExpensiveFunction(arg); })|. This ensures
508 * that the expensive expression is only evaluated when its result will
509 * actually be used.
510 */
511 template <typename V>
512 constexpr T valueOr(V&& aDefault) const {
513 if (isSome()) {
514 return ref();
515 }
516 return std::forward<V>(aDefault);
517 }
518
519 /*
520 * Returns the contents of this Maybe<T> by value. If |isNothing()|, returns
521 * the value returned from the function or functor provided.
522 */
523 template <typename F>
524 constexpr T valueOrFrom(F&& aFunc) const {
525 if (isSome()) {
526 return ref();
527 }
528 return aFunc();
529 }
530
531 /* Returns the contents of this Maybe<T> by pointer. Unsafe unless |isSome()|.
532 */
533 T* ptr();
534 constexpr const T* ptr() const;
535
536 /*
537 * Returns the contents of this Maybe<T> by pointer. If |isNothing()|,
538 * returns the default value provided.
539 */
540 T* ptrOr(T* aDefault) {
541 if (isSome()) {
542 return ptr();
543 }
544 return aDefault;
545 }
546
547 constexpr const T* ptrOr(const T* aDefault) const {
548 if (isSome()) {
549 return ptr();
550 }
551 return aDefault;
552 }
553
554 /*
555 * Returns the contents of this Maybe<T> by pointer. If |isNothing()|,
556 * returns the value returned from the function or functor provided.
557 */
558 template <typename F>
559 T* ptrOrFrom(F&& aFunc) {
560 if (isSome()) {
561 return ptr();
562 }
563 return aFunc();
564 }
565
566 template <typename F>
567 const T* ptrOrFrom(F&& aFunc) const {
568 if (isSome()) {
569 return ptr();
570 }
571 return aFunc();
572 }
573
574 constexpr T* operator->();
575 constexpr const T* operator->() const;
576
577 /* Returns the contents of this Maybe<T> by ref. Unsafe unless |isSome()|. */
578 constexpr T& ref() &;
579 constexpr const T& ref() const&;
580 constexpr T&& ref() &&;
581 constexpr const T&& ref() const&&;
582
583 /*
584 * Returns the contents of this Maybe<T> by ref. If |isNothing()|, returns
585 * the default value provided.
586 */
587 constexpr T& refOr(T& aDefault) {
588 if (isSome()) {
589 return ref();
590 }
591 return aDefault;
592 }
593
594 constexpr const T& refOr(const T& aDefault) const {
595 if (isSome()) {
596 return ref();
597 }
598 return aDefault;
599 }
600
601 /*
602 * Returns the contents of this Maybe<T> by ref. If |isNothing()|, returns the
603 * value returned from the function or functor provided.
604 */
605 template <typename F>
606 constexpr T& refOrFrom(F&& aFunc) {
607 if (isSome()) {
608 return ref();
609 }
610 return aFunc();
611 }
612
613 template <typename F>
614 constexpr const T& refOrFrom(F&& aFunc) const {
615 if (isSome()) {
616 return ref();
617 }
618 return aFunc();
619 }
620
621 constexpr T& operator*() &;
622 constexpr const T& operator*() const&;
623 constexpr T&& operator*() &&;
624 constexpr const T&& operator*() const&&;
625
626 /* If |isSome()|, runs the provided function or functor on the contents of
627 * this Maybe. */
628 template <typename Func>
629 constexpr Maybe& apply(Func&& aFunc) & {
630 if (isSome()) {
631 std::forward<Func>(aFunc)(ref());
632 }
633 return *this;
634 }
635
636 template <typename Func>
637 constexpr const Maybe& apply(Func&& aFunc) const& {
638 if (isSome()) {
639 std::forward<Func>(aFunc)(ref());
640 }
641 return *this;
642 }
643
644 template <typename Func>
645 constexpr Maybe& apply(Func&& aFunc) && {
646 if (isSome()) {
647 std::forward<Func>(aFunc)(extract());
648 }
649 return *this;
650 }
651
652 template <typename Func>
653 constexpr Maybe& apply(Func&& aFunc) const&& {
654 if (isSome()) {
655 std::forward<Func>(aFunc)(extract());
656 }
657 return *this;
658 }
659
660 /*
661 * If |isSome()|, runs the provided function and returns the result wrapped
662 * in a Maybe. If |isNothing()|, returns an empty Maybe value with the same
663 * value type as what the provided function would have returned.
664 */
665 template <typename Func>
666 constexpr auto map(Func&& aFunc) & {
667 if (isSome()) {
668 return Some(std::forward<Func>(aFunc)(ref()));
669 }
670 return Maybe<decltype(std::forward<Func>(aFunc)(ref()))>{};
671 }
672
673 template <typename Func>
674 constexpr auto map(Func&& aFunc) const& {
675 if (isSome()) {
676 return Some(std::forward<Func>(aFunc)(ref()));
677 }
678 return Maybe<decltype(std::forward<Func>(aFunc)(ref()))>{};
679 }
680
681 template <typename Func>
682 constexpr auto map(Func&& aFunc) && {
683 if (isSome()) {
684 return Some(std::forward<Func>(aFunc)(extract()));
685 }
686 return Maybe<decltype(std::forward<Func>(aFunc)(extract()))>{};
687 }
688
689 template <typename Func>
690 constexpr auto map(Func&& aFunc) const&& {
691 if (isSome()) {
692 return Some(std::forward<Func>(aFunc)(extract()));
693 }
694 return Maybe<decltype(std::forward<Func>(aFunc)(extract()))>{};
695 }
696
697 /*
698 * If |isSome()|, runs the provided function or functor on the contents of
699 * this Maybe and returns the result. Note that the provided function or
700 * functor must return a Maybe<U> of any type U.
701 * If |isNothing()|, returns an empty Maybe value with the same type as what
702 * the provided function would have returned.
703 */
704 template <typename Func>
705 constexpr auto andThen(Func&& aFunc) & {
706 static_assert(std::is_invocable_v<Func, T&>);
707 using U = std::invoke_result_t<Func, T&>;
708 static_assert(detail::IsMaybe<U>::value);
709 if (isSome()) {
710 return std::invoke(std::forward<Func>(aFunc), ref());
711 }
712 return std::remove_cv_t<std::remove_reference_t<U>>{};
713 }
714
715 template <typename Func>
716 constexpr auto andThen(Func&& aFunc) const& {
717 static_assert(std::is_invocable_v<Func, const T&>);
718 using U = std::invoke_result_t<Func, const T&>;
719 static_assert(detail::IsMaybe<U>::value);
720 if (isSome()) {
721 return std::invoke(std::forward<Func>(aFunc), ref());
722 }
723 return std::remove_cv_t<std::remove_reference_t<U>>{};
724 }
725
726 template <typename Func>
727 constexpr auto andThen(Func&& aFunc) && {
728 static_assert(std::is_invocable_v<Func, T&&>);
729 using U = std::invoke_result_t<Func, T&&>;
730 static_assert(detail::IsMaybe<U>::value);
731 if (isSome()) {
732 return std::invoke(std::forward<Func>(aFunc), extract());
733 }
734 return std::remove_cv_t<std::remove_reference_t<U>>{};
735 }
736
737 template <typename Func>
738 constexpr auto andThen(Func&& aFunc) const&& {
739 static_assert(std::is_invocable_v<Func, const T&&>);
740 using U = std::invoke_result_t<Func, const T&&>;
741 static_assert(detail::IsMaybe<U>::value);
742 if (isSome()) {
743 return std::invoke(std::forward<Func>(aFunc), extract());
744 }
745 return std::remove_cv_t<std::remove_reference_t<U>>{};
746 }
747
748 /*
749 * If |isNothing()|, runs the provided function or functor and returns its
750 * result. If |isSome()|, returns the contained value wrapped in a Maybe.
751 */
752 template <typename Func>
753 constexpr Maybe orElse(Func&& aFunc) & {
754 static_assert(std::is_invocable_v<Func>);
755 using U = std::invoke_result_t<Func>;
756 static_assert(
757 std::is_same_v<Maybe, std::remove_cv_t<std::remove_reference_t<U>>>);
758 if (isSome()) {
759 return *this;
760 }
761 return std::invoke(std::forward<Func>(aFunc));
762 }
763
764 template <typename Func>
765 constexpr Maybe orElse(Func&& aFunc) const& {
766 static_assert(std::is_invocable_v<Func>);
767 using U = std::invoke_result_t<Func>;
768 static_assert(
769 std::is_same_v<Maybe, std::remove_cv_t<std::remove_reference_t<U>>>);
770 if (isSome()) {
771 return *this;
772 }
773 return std::invoke(std::forward<Func>(aFunc));
774 }
775
776 template <typename Func>
777 constexpr Maybe orElse(Func&& aFunc) && {
778 static_assert(std::is_invocable_v<Func>);
779 using U = std::invoke_result_t<Func>;
780 static_assert(
781 std::is_same_v<Maybe, std::remove_cv_t<std::remove_reference_t<U>>>);
782 if (isSome()) {
783 return std::move(*this);
784 }
785 return std::invoke(std::forward<Func>(aFunc));
786 }
787
788 template <typename Func>
789 constexpr Maybe orElse(Func&& aFunc) const&& {
790 static_assert(std::is_invocable_v<Func>);
791 using U = std::invoke_result_t<Func>;
792 static_assert(
793 std::is_same_v<Maybe, std::remove_cv_t<std::remove_reference_t<U>>>);
794 if (isSome()) {
795 return std::move(*this);
796 }
797 return std::invoke(std::forward<Func>(aFunc));
798 }
799
800 /* If |isSome()|, empties this Maybe and destroys its contents. */
801 constexpr void reset() {
802 if (isSome()) {
803 if constexpr (!std::is_trivially_destructible_v<T>) {
804 /*
805 * Static analyzer gets confused if we have Maybe<MutexAutoLock>,
806 * so we suppress thread-safety warnings here
807 */
808 MOZ_PUSH_IGNORE_THREAD_SAFETYGCC diagnostic push GCC diagnostic ignored "-Wthread-safety"
809 ref().T::~T();
810 MOZ_POP_THREAD_SAFETYGCC diagnostic pop
811 poisonData();
812 }
813 mIsSome = false;
814 }
815 }
816
817 /*
818 * Constructs a T value in-place in this empty Maybe<T>'s storage. The
819 * arguments to |emplace()| are the parameters to T's constructor.
820 */
821 template <typename... Args>
822 constexpr void emplace(Args&&... aArgs);
823
824 template <typename U>
825 constexpr std::enable_if_t<std::is_same_v<T, U> &&
826 std::is_copy_constructible_v<U> &&
827 !std::is_move_constructible_v<U>>
828 emplace(U&& aArgs) {
829 emplace(aArgs);
830 }
831
832 friend std::ostream& operator<<(std::ostream& aStream,
833 const Maybe<T>& aMaybe) {
834 if (aMaybe) {
835 aStream << aMaybe.ref();
836 } else {
837 aStream << "<Nothing>";
838 }
839 return aStream;
840 }
841};
842
843template <typename T>
844class Maybe<T&> {
845 public:
846 constexpr Maybe() = default;
847 constexpr MOZ_IMPLICIT Maybe(Nothing) {}
848
849 void emplace(T& aRef) { mValue = &aRef; }
850
851 /* Methods that check whether this Maybe contains a value */
852 constexpr explicit operator bool() const { return isSome(); }
853 constexpr bool isSome() const { return mValue; }
854 constexpr bool isNothing() const { return !mValue; }
855
856 T& ref() const {
857 MOZ_RELEASE_ASSERT(isSome())do { static_assert( mozilla::detail::AssertionConditionType<
decltype(isSome())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(isSome()))), 0))) { do { } while
(false); MOZ_ReportAssertionFailure("isSome()", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/mozilla/Maybe.h"
, 857); AnnotateMozCrashReason("MOZ_RELEASE_ASSERT" "(" "isSome()"
")"); do { *((volatile int*)__null) = 857; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
858 return *mValue;
859 }
860
861 T* operator->() const { return &ref(); }
862 T& operator*() const { return ref(); }
863
864 // Deliberately not defining value and ptr accessors, as these may be
865 // confusing on a reference-typed Maybe.
866
867 // XXX Should we define refOr?
868
869 void reset() { mValue = nullptr; }
870
871 template <typename Func>
872 const Maybe& apply(Func&& aFunc) const {
873 if (isSome()) {
874 std::forward<Func>(aFunc)(ref());
875 }
876 return *this;
877 }
878
879 template <typename Func>
880 auto map(Func&& aFunc) const {
881 Maybe<decltype(std::forward<Func>(aFunc)(ref()))> val;
882 if (isSome()) {
883 val.emplace(std::forward<Func>(aFunc)(ref()));
884 }
885 return val;
886 }
887
888 template <typename Func>
889 constexpr auto andThen(Func&& aFunc) const {
890 static_assert(std::is_invocable_v<Func, T&>);
891 using U = std::invoke_result_t<Func, T&>;
892 static_assert(detail::IsMaybe<U>::value);
893 if (isSome()) {
894 return std::invoke(std::forward<Func>(aFunc), ref());
895 }
896 return std::remove_cv_t<std::remove_reference_t<U>>{};
897 }
898
899 template <typename Func>
900 constexpr Maybe orElse(Func&& aFunc) const {
901 static_assert(std::is_invocable_v<Func>);
902 using U = std::invoke_result_t<Func>;
903 static_assert(
904 std::is_same_v<Maybe, std::remove_cv_t<std::remove_reference_t<U>>>);
905 if (isSome()) {
906 return *this;
907 }
908 return std::invoke(std::forward<Func>(aFunc));
909 }
910
911 bool refEquals(const Maybe<T&>& aOther) const {
912 return mValue == aOther.mValue;
913 }
914
915 bool refEquals(const T& aOther) const { return mValue == &aOther; }
916
917 private:
918 T* mValue = nullptr;
919};
920
921template <typename T>
922constexpr T Maybe<T>::value() const& {
923 MOZ_RELEASE_ASSERT(isSome())do { static_assert( mozilla::detail::AssertionConditionType<
decltype(isSome())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(isSome()))), 0))) { do { } while
(false); MOZ_ReportAssertionFailure("isSome()", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/mozilla/Maybe.h"
, 923); AnnotateMozCrashReason("MOZ_RELEASE_ASSERT" "(" "isSome()"
")"); do { *((volatile int*)__null) = 923; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
924 return ref();
925}
926
927template <typename T>
928constexpr T Maybe<T>::value() && {
929 MOZ_RELEASE_ASSERT(isSome())do { static_assert( mozilla::detail::AssertionConditionType<
decltype(isSome())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(isSome()))), 0))) { do { } while
(false); MOZ_ReportAssertionFailure("isSome()", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/mozilla/Maybe.h"
, 929); AnnotateMozCrashReason("MOZ_RELEASE_ASSERT" "(" "isSome()"
")"); do { *((volatile int*)__null) = 929; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
930 return std::move(ref());
931}
932
933template <typename T>
934constexpr T Maybe<T>::value() const&& {
935 MOZ_RELEASE_ASSERT(isSome())do { static_assert( mozilla::detail::AssertionConditionType<
decltype(isSome())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(isSome()))), 0))) { do { } while
(false); MOZ_ReportAssertionFailure("isSome()", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/mozilla/Maybe.h"
, 935); AnnotateMozCrashReason("MOZ_RELEASE_ASSERT" "(" "isSome()"
")"); do { *((volatile int*)__null) = 935; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
936 return std::move(ref());
937}
938
939template <typename T>
940T* Maybe<T>::ptr() {
941 MOZ_RELEASE_ASSERT(isSome())do { static_assert( mozilla::detail::AssertionConditionType<
decltype(isSome())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(isSome()))), 0))) { do { } while
(false); MOZ_ReportAssertionFailure("isSome()", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/mozilla/Maybe.h"
, 941); AnnotateMozCrashReason("MOZ_RELEASE_ASSERT" "(" "isSome()"
")"); do { *((volatile int*)__null) = 941; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
942 return &ref();
943}
944
945template <typename T>
946constexpr const T* Maybe<T>::ptr() const {
947 MOZ_RELEASE_ASSERT(isSome())do { static_assert( mozilla::detail::AssertionConditionType<
decltype(isSome())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(isSome()))), 0))) { do { } while
(false); MOZ_ReportAssertionFailure("isSome()", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/mozilla/Maybe.h"
, 947); AnnotateMozCrashReason("MOZ_RELEASE_ASSERT" "(" "isSome()"
")"); do { *((volatile int*)__null) = 947; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
948 return &ref();
949}
950
951template <typename T>
952constexpr T* Maybe<T>::operator->() {
953 MOZ_RELEASE_ASSERT(isSome())do { static_assert( mozilla::detail::AssertionConditionType<
decltype(isSome())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(isSome()))), 0))) { do { } while
(false); MOZ_ReportAssertionFailure("isSome()", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/mozilla/Maybe.h"
, 953); AnnotateMozCrashReason("MOZ_RELEASE_ASSERT" "(" "isSome()"
")"); do { *((volatile int*)__null) = 953; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
954 return ptr();
955}
956
957template <typename T>
958constexpr const T* Maybe<T>::operator->() const {
959 MOZ_RELEASE_ASSERT(isSome())do { static_assert( mozilla::detail::AssertionConditionType<
decltype(isSome())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(isSome()))), 0))) { do { } while
(false); MOZ_ReportAssertionFailure("isSome()", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/mozilla/Maybe.h"
, 959); AnnotateMozCrashReason("MOZ_RELEASE_ASSERT" "(" "isSome()"
")"); do { *((volatile int*)__null) = 959; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
960 return ptr();
961}
962
963template <typename T>
964constexpr T& Maybe<T>::ref() & {
965 MOZ_RELEASE_ASSERT(isSome())do { static_assert( mozilla::detail::AssertionConditionType<
decltype(isSome())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(isSome()))), 0))) { do { } while
(false); MOZ_ReportAssertionFailure("isSome()", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/mozilla/Maybe.h"
, 965); AnnotateMozCrashReason("MOZ_RELEASE_ASSERT" "(" "isSome()"
")"); do { *((volatile int*)__null) = 965; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
966 return mStorage.val;
967}
968
969template <typename T>
970constexpr const T& Maybe<T>::ref() const& {
971 MOZ_RELEASE_ASSERT(isSome())do { static_assert( mozilla::detail::AssertionConditionType<
decltype(isSome())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(isSome()))), 0))) { do { } while
(false); MOZ_ReportAssertionFailure("isSome()", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/mozilla/Maybe.h"
, 971); AnnotateMozCrashReason("MOZ_RELEASE_ASSERT" "(" "isSome()"
")"); do { *((volatile int*)__null) = 971; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
972 return mStorage.val;
973}
974
975template <typename T>
976constexpr T&& Maybe<T>::ref() && {
977 MOZ_RELEASE_ASSERT(isSome())do { static_assert( mozilla::detail::AssertionConditionType<
decltype(isSome())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(isSome()))), 0))) { do { } while
(false); MOZ_ReportAssertionFailure("isSome()", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/mozilla/Maybe.h"
, 977); AnnotateMozCrashReason("MOZ_RELEASE_ASSERT" "(" "isSome()"
")"); do { *((volatile int*)__null) = 977; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
978 return std::move(mStorage.val);
979}
980
981template <typename T>
982constexpr const T&& Maybe<T>::ref() const&& {
983 MOZ_RELEASE_ASSERT(isSome())do { static_assert( mozilla::detail::AssertionConditionType<
decltype(isSome())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(isSome()))), 0))) { do { } while
(false); MOZ_ReportAssertionFailure("isSome()", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/mozilla/Maybe.h"
, 983); AnnotateMozCrashReason("MOZ_RELEASE_ASSERT" "(" "isSome()"
")"); do { *((volatile int*)__null) = 983; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
984 return std::move(mStorage.val);
985}
986
987template <typename T>
988constexpr T& Maybe<T>::operator*() & {
989 MOZ_RELEASE_ASSERT(isSome())do { static_assert( mozilla::detail::AssertionConditionType<
decltype(isSome())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(isSome()))), 0))) { do { } while
(false); MOZ_ReportAssertionFailure("isSome()", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/mozilla/Maybe.h"
, 989); AnnotateMozCrashReason("MOZ_RELEASE_ASSERT" "(" "isSome()"
")"); do { *((volatile int*)__null) = 989; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
990 return ref();
991}
992
993template <typename T>
994constexpr const T& Maybe<T>::operator*() const& {
995 MOZ_RELEASE_ASSERT(isSome())do { static_assert( mozilla::detail::AssertionConditionType<
decltype(isSome())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(isSome()))), 0))) { do { } while
(false); MOZ_ReportAssertionFailure("isSome()", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/mozilla/Maybe.h"
, 995); AnnotateMozCrashReason("MOZ_RELEASE_ASSERT" "(" "isSome()"
")"); do { *((volatile int*)__null) = 995; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
996 return ref();
997}
998
999template <typename T>
1000constexpr T&& Maybe<T>::operator*() && {
1001 MOZ_RELEASE_ASSERT(isSome())do { static_assert( mozilla::detail::AssertionConditionType<
decltype(isSome())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(isSome()))), 0))) { do { } while
(false); MOZ_ReportAssertionFailure("isSome()", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/mozilla/Maybe.h"
, 1001); AnnotateMozCrashReason("MOZ_RELEASE_ASSERT" "(" "isSome()"
")"); do { *((volatile int*)__null) = 1001; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
1002 return std::move(ref());
1003}
1004
1005template <typename T>
1006constexpr const T&& Maybe<T>::operator*() const&& {
1007 MOZ_RELEASE_ASSERT(isSome())do { static_assert( mozilla::detail::AssertionConditionType<
decltype(isSome())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(isSome()))), 0))) { do { } while
(false); MOZ_ReportAssertionFailure("isSome()", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/mozilla/Maybe.h"
, 1007); AnnotateMozCrashReason("MOZ_RELEASE_ASSERT" "(" "isSome()"
")"); do { *((volatile int*)__null) = 1007; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
1008 return std::move(ref());
1009}
1010
1011template <typename T>
1012template <typename... Args>
1013constexpr void Maybe<T>::emplace(Args&&... aArgs) {
1014 MOZ_RELEASE_ASSERT(!isSome())do { static_assert( mozilla::detail::AssertionConditionType<
decltype(!isSome())>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(!isSome()))), 0))) { do { } while
(false); MOZ_ReportAssertionFailure("!isSome()", "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/mozilla/Maybe.h"
, 1014); AnnotateMozCrashReason("MOZ_RELEASE_ASSERT" "(" "!isSome()"
")"); do { *((volatile int*)__null) = 1014; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
1015 ::new (KnownNotNull, &mStorage.val) T(std::forward<Args>(aArgs)...);
1016 mIsSome = true;
1017}
1018
1019/*
1020 * Some() creates a Maybe<T> value containing the provided T value. If T has a
1021 * move constructor, it's used to make this as efficient as possible.
1022 *
1023 * Some() selects the type of Maybe it returns by removing any const, volatile,
1024 * or reference qualifiers from the type of the value you pass to it. This gives
1025 * it more intuitive behavior when used in expressions, but it also means that
1026 * if you need to construct a Maybe value that holds a const, volatile, or
1027 * reference value, you need to use emplace() instead.
1028 */
1029template <typename T, typename U>
1030constexpr Maybe<U> Some(T&& aValue) {
1031 return {std::forward<T>(aValue), typename Maybe<U>::SomeGuard{}};
1032}
1033
1034template <typename T>
1035constexpr Maybe<T&> SomeRef(T& aValue) {
1036 Maybe<T&> value;
1037 value.emplace(aValue);
1038 return value;
1039}
1040
1041template <typename T>
1042constexpr Maybe<T&> ToMaybeRef(T* const aPtr) {
1043 return aPtr ? SomeRef(*aPtr) : Nothing{};
1044}
1045
1046template <typename T>
1047Maybe<std::remove_cv_t<std::remove_reference_t<T>>> ToMaybe(T* aPtr) {
1048 if (aPtr) {
1049 return Some(*aPtr);
1050 }
1051 return Nothing();
1052}
1053
1054/*
1055 * Two Maybe<T> values are equal if
1056 * - both are Nothing, or
1057 * - both are Some, and the values they contain are equal.
1058 */
1059template <typename T>
1060constexpr bool operator==(const Maybe<T>& aLHS, const Maybe<T>& aRHS) {
1061 static_assert(!std::is_reference_v<T>,
1062 "operator== is not defined for Maybe<T&>, compare values or "
1063 "addresses explicitly instead");
1064 if (aLHS.isNothing() != aRHS.isNothing()) {
1065 return false;
1066 }
1067 return aLHS.isNothing() || *aLHS == *aRHS;
1068}
1069
1070template <typename T>
1071constexpr bool operator!=(const Maybe<T>& aLHS, const Maybe<T>& aRHS) {
1072 return !(aLHS == aRHS);
1073}
1074
1075/*
1076 * We support comparison to Nothing to allow reasonable expressions like:
1077 * if (maybeValue == Nothing()) { ... }
1078 */
1079template <typename T>
1080constexpr bool operator==(const Maybe<T>& aLHS, const Nothing& aRHS) {
1081 return aLHS.isNothing();
1082}
1083
1084template <typename T>
1085constexpr bool operator!=(const Maybe<T>& aLHS, const Nothing& aRHS) {
1086 return !(aLHS == aRHS);
1087}
1088
1089template <typename T>
1090constexpr bool operator==(const Nothing& aLHS, const Maybe<T>& aRHS) {
1091 return aRHS.isNothing();
1092}
1093
1094template <typename T>
1095constexpr bool operator!=(const Nothing& aLHS, const Maybe<T>& aRHS) {
1096 return !(aLHS == aRHS);
1097}
1098
1099/*
1100 * Maybe<T> values are ordered in the same way T values are ordered, except that
1101 * Nothing comes before anything else.
1102 */
1103template <typename T>
1104constexpr bool operator<(const Maybe<T>& aLHS, const Maybe<T>& aRHS) {
1105 if (aLHS.isNothing()) {
1106 return aRHS.isSome();
1107 }
1108 if (aRHS.isNothing()) {
1109 return false;
1110 }
1111 return *aLHS < *aRHS;
1112}
1113
1114template <typename T>
1115constexpr bool operator>(const Maybe<T>& aLHS, const Maybe<T>& aRHS) {
1116 return !(aLHS < aRHS || aLHS == aRHS);
1117}
1118
1119template <typename T>
1120constexpr bool operator<=(const Maybe<T>& aLHS, const Maybe<T>& aRHS) {
1121 return aLHS < aRHS || aLHS == aRHS;
1122}
1123
1124template <typename T>
1125constexpr bool operator>=(const Maybe<T>& aLHS, const Maybe<T>& aRHS) {
1126 return !(aLHS < aRHS);
1127}
1128
1129template <typename T>
1130inline void ImplCycleCollectionTraverse(
1131 nsCycleCollectionTraversalCallback& aCallback, mozilla::Maybe<T>& aField,
1132 const char* aName, uint32_t aFlags = 0) {
1133 if (aField) {
1134 ImplCycleCollectionTraverse(aCallback, aField.ref(), aName, aFlags);
1135 }
1136}
1137
1138template <typename T>
1139inline void ImplCycleCollectionUnlink(mozilla::Maybe<T>& aField) {
1140 if (aField) {
1141 ImplCycleCollectionUnlink(aField.ref());
1142 }
1143}
1144
1145} // namespace mozilla
1146
1147#endif /* mozilla_Maybe_h */

/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/mozilla/ipc/ByteBuf.h

1/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
2/* vim: set ts=8 sts=2 et sw=2 tw=80: */
3/* This Source Code Form is subject to the terms of the Mozilla Public
4 * License, v. 2.0. If a copy of the MPL was not distributed with this
5 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
6
7/* A type that can be sent without needing to make a copy during
8 * serialization. In addition the receiver can take ownership of the
9 * data to avoid having to make an additional copy. */
10
11#ifndef mozilla_ipc_ByteBuf_h
12#define mozilla_ipc_ByteBuf_h
13
14#include "mozilla/Assertions.h"
15
16namespace IPC {
17template <typename T>
18struct ParamTraits;
19}
20
21namespace mozilla {
22
23namespace ipc {
24
25class ByteBuf final {
26 friend struct IPC::ParamTraits<mozilla::ipc::ByteBuf>;
27
28 public:
29 bool Allocate(size_t aLength) {
30 MOZ_ASSERT(mData == nullptr)do { static_assert( mozilla::detail::AssertionConditionType<
decltype(mData == nullptr)>::isValid, "invalid assertion condition"
); if ((__builtin_expect(!!(!(!!(mData == nullptr))), 0))) { do
{ } while (false); MOZ_ReportAssertionFailure("mData == nullptr"
, "/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/mozilla/ipc/ByteBuf.h"
, 30); AnnotateMozCrashReason("MOZ_ASSERT" "(" "mData == nullptr"
")"); do { *((volatile int*)__null) = 30; __attribute__((nomerge
)) ::abort(); } while (false); } } while (false)
;
31 mData = (uint8_t*)malloc(aLength);
32 if (!mData) {
33 return false;
34 }
35 mLen = aLength;
36 mCapacity = aLength;
37 return true;
38 }
39
40 ByteBuf() : mData(nullptr), mLen(0), mCapacity(0) {}
41
42 ByteBuf(uint8_t* aData, size_t aLen, size_t aCapacity)
43 : mData(aData), mLen(aLen), mCapacity(aCapacity) {}
44
45 ByteBuf(const ByteBuf& aFrom) = delete;
46
47 ByteBuf(ByteBuf&& aFrom)
48 : mData(aFrom.mData), mLen(aFrom.mLen), mCapacity(aFrom.mCapacity) {
49 aFrom.mData = nullptr;
50 aFrom.mLen = 0;
51 aFrom.mCapacity = 0;
52 }
53
54 ByteBuf& operator=(ByteBuf&& aFrom) {
55 std::swap(mData, aFrom.mData);
56 std::swap(mLen, aFrom.mLen);
57 std::swap(mCapacity, aFrom.mCapacity);
58 return *this;
59 }
60
61 ~ByteBuf() { free(mData); }
12
Memory is released
17
Attempt to free released memory
62
63 uint8_t* mData;
64 size_t mLen;
65 size_t mCapacity;
66};
67
68} // namespace ipc
69} // namespace mozilla
70
71#endif // ifndef mozilla_ipc_ByteBuf_h

/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/mozilla/MaybeStorageBase.h

1/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
2/* vim: set ts=8 sts=2 et sw=2 tw=80: */
3/* This Source Code Form is subject to the terms of the Mozilla Public
4 * License, v. 2.0. If a copy of the MPL was not distributed with this
5 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
6
7/* Internal storage class used e.g. by Maybe and Result. This file doesn't
8 * contain any public declarations. */
9
10#ifndef mfbt_MaybeStorageBase_h
11#define mfbt_MaybeStorageBase_h
12
13#include <type_traits>
14#include <utility>
15
16namespace mozilla::detail {
17
18template <typename T>
19constexpr bool IsTriviallyDestructibleAndCopyable =
20 std::is_trivially_destructible_v<T> &&
21 (std::is_trivially_copy_constructible_v<T> ||
22 !std::is_copy_constructible_v<T>);
23
24template <typename T, bool TriviallyDestructibleAndCopyable =
25 IsTriviallyDestructibleAndCopyable<T>>
26struct MaybeStorageBase;
27
28template <typename T>
29struct MaybeStorageBase<T, false> {
30 protected:
31 using NonConstT = std::remove_const_t<T>;
32
33 union Union {
34 Union() {}
35 explicit Union(const T& aVal) : val{aVal} {}
36 template <typename U,
37 typename = std::enable_if_t<std::is_move_constructible_v<U>>>
38 explicit Union(U&& aVal) : val{std::forward<U>(aVal)} {}
39 template <typename... Args>
40 explicit Union(std::in_place_t, Args&&... aArgs)
41 : val{std::forward<Args>(aArgs)...} {}
42
43 ~Union() {}
16
Calling '~ByteBuf'
44
45 NonConstT val;
46 } mStorage;
47
48 public:
49 MaybeStorageBase() = default;
50 explicit MaybeStorageBase(const T& aVal) : mStorage{aVal} {}
51 explicit MaybeStorageBase(T&& aVal) : mStorage{std::move(aVal)} {}
52 template <typename... Args>
53 explicit MaybeStorageBase(std::in_place_t, Args&&... aArgs)
54 : mStorage{std::in_place, std::forward<Args>(aArgs)...} {}
55
56 const T* addr() const { return &mStorage.val; }
57 T* addr() { return &mStorage.val; }
58};
59
60template <typename T>
61struct MaybeStorageBase<T, true> {
62 protected:
63 using NonConstT = std::remove_const_t<T>;
64
65 union Union {
66 constexpr Union() : dummy() {}
67 constexpr explicit Union(const T& aVal) : val{aVal} {}
68 constexpr explicit Union(T&& aVal) : val{std::move(aVal)} {}
69 template <typename... Args>
70 constexpr explicit Union(std::in_place_t, Args&&... aArgs)
71 : val{std::forward<Args>(aArgs)...} {}
72
73 NonConstT val;
74 char dummy;
75 } mStorage;
76
77 public:
78 constexpr MaybeStorageBase() = default;
79 constexpr explicit MaybeStorageBase(const T& aVal) : mStorage{aVal} {}
80 constexpr explicit MaybeStorageBase(T&& aVal) : mStorage{std::move(aVal)} {}
81
82 template <typename... Args>
83 constexpr explicit MaybeStorageBase(std::in_place_t, Args&&... aArgs)
84 : mStorage{std::in_place, std::forward<Args>(aArgs)...} {}
85
86 constexpr const T* addr() const { return &mStorage.val; }
87 constexpr T* addr() { return &mStorage.val; }
88};
89
90} // namespace mozilla::detail
91
92#endif