1 files changed, 135 insertions, 0 deletions
diff --git a/dom/events/DataTransferItem.h b/dom/events/DataTransferItem.h
new file mode 100644
index 0000000000..111f498e82
--- /dev/null
+++ b/dom/events/DataTransferItem.h
@@ -0,0 +1,135 @@
+/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
+/* vim: set ts=8 sts=2 et sw=2 tw=80: */
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+#ifndef mozilla_dom_DataTransferItem_h
+#define mozilla_dom_DataTransferItem_h
+
+#include "mozilla/dom/DataTransfer.h"
+#include "mozilla/dom/DOMString.h"
+#include "mozilla/dom/File.h"
+
+namespace mozilla {
+class ErrorResult;
+
+namespace dom {
+
+class DataTransfer;
+class FileSystemEntry;
+class FunctionStringCallback;
+
+class DataTransferItem final : public nsISupports, public nsWrapperCache {
+ public:
+  NS_DECL_CYCLE_COLLECTING_ISUPPORTS
+  NS_DECL_CYCLE_COLLECTION_WRAPPERCACHE_CLASS(DataTransferItem);
+
+ public:
+  // The spec only talks about the "file" and "string" kinds. Due to the Moz*
+  // APIs, it is possible to attach any type to a DataTransferItem, meaning that
+  // we can have other kinds then just FILE and STRING. These others are simply
+  // marked as "other" and can only be produced throug the Moz* APIs.
+  enum eKind {
+    KIND_FILE,
+    KIND_STRING,
+    KIND_OTHER,
+  };
+
+  DataTransferItem(DataTransfer* aDataTransfer, const nsAString& aType,
+                   eKind aKind = KIND_OTHER)
+      : mIndex(0),
+        mChromeOnly(false),
+        mKind(aKind),
+        mType(aType),
+        mDataTransfer(aDataTransfer) {
+    MOZ_ASSERT(mDataTransfer, "Must be associated with a DataTransfer");
+  }
+
+  already_AddRefed<DataTransferItem> Clone(DataTransfer* aDataTransfer) const;
+
+  virtual JSObject* WrapObject(JSContext* aCx,
+                               JS::Handle<JSObject*> aGivenProto) override;
+
+  void GetAsString(FunctionStringCallback* aCallback,
+                   nsIPrincipal& aSubjectPrincipal, ErrorResult& aRv);
+
+  void GetKind(nsAString& aKind) const {
+    switch (mKind) {
+      case KIND_FILE:
+        aKind = u"file"_ns;
+        return;
+      case KIND_STRING:
+        aKind = u"string"_ns;
+        return;
+      default:
+        aKind = u"other"_ns;
+        return;
+    }
+  }
+
+  void GetInternalType(nsAString& aType) const { aType = mType; }
+  bool IsInternalType(const nsAString& aType) const { return aType == mType; }
+
+  void GetType(nsAString& aType);
+
+  eKind Kind() const { return mKind; }
+
+  already_AddRefed<File> GetAsFile(nsIPrincipal& aSubjectPrincipal,
+                                   ErrorResult& aRv);
+
+  already_AddRefed<FileSystemEntry> GetAsEntry(nsIPrincipal& aSubjectPrincipal,
+                                               ErrorResult& aRv);
+
+  DataTransfer* GetParentObject() const { return mDataTransfer; }
+
+  nsIPrincipal* Principal() const { return mPrincipal; }
+  void SetPrincipal(nsIPrincipal* aPrincipal) { mPrincipal = aPrincipal; }
+
+  // @return cached data, if available.
+  //         otherwise: if available, `mDataTransfer`'s transferable data.
+  //                    otherwise the data is retrieved from the clipboard (for
+  //                    paste events) or the drag session.
+  already_AddRefed<nsIVariant> DataNoSecurityCheck();
+  // Data may return null if the clipboard state has changed since the type was
+  // detected.
+  already_AddRefed<nsIVariant> Data(nsIPrincipal* aPrincipal, ErrorResult& aRv);
+
+  // Note: This can modify the mKind.  Callers of this method must let the
+  // relevant DataTransfer know, because its types list can change as a result.
+  void SetData(nsIVariant* aData);
+
+  uint32_t Index() const { return mIndex; }
+  void SetIndex(uint32_t aIndex) { mIndex = aIndex; }
+  void FillInExternalData();
+
+  bool ChromeOnly() const { return mChromeOnly; }
+  void SetChromeOnly(bool aChromeOnly) { mChromeOnly = aChromeOnly; }
+
+  static eKind KindFromData(nsIVariant* aData);
+
+ private:
+  ~DataTransferItem() = default;
+  already_AddRefed<File> CreateFileFromInputStream(nsIInputStream* aStream);
+  already_AddRefed<File> CreateFileFromInputStream(
+      nsIInputStream* aStream, const char* aFileNameKey,
+      const nsAString& aContentType);
+
+  // The index in the 2d mIndexedItems array
+  uint32_t mIndex;
+
+  bool mChromeOnly;
+  eKind mKind;
+  const nsString mType;
+  nsCOMPtr<nsIVariant> mData;
+  nsCOMPtr<nsIPrincipal> mPrincipal;
+  RefPtr<DataTransfer> mDataTransfer;
+
+  // File cache for nsIFile application/x-moz-file entries.
+  RefPtr<File> mCachedFile;
+};
+
+}  // namespace dom
+}  // namespace mozilla
+
+#endif /* mozilla_dom_DataTransferItem_h */