author Dylan Roeh <>
Tue, 28 Aug 2018 11:35:46 -0500
changeset 481113 31683bdf39d7bcacf8d9bf265fc2365024473fbe
parent 476293 66f6b8d84e5d35d0de8d07d3e9de44a9cce913f2
child 508163 6f3709b3878117466168c40affa7bca0b60cf75b
permissions -rw-r--r--
Bug 1485178 - Only migrate sharedprefs when in Fennec. r=snorp a=ritu

/* -*- 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 */

#ifndef mozilla_dom_FormData_h
#define mozilla_dom_FormData_h

#include "mozilla/Attributes.h"
#include "mozilla/ErrorResult.h"
#include "mozilla/dom/BindingDeclarations.h"
#include "mozilla/dom/HTMLFormSubmission.h"
#include "mozilla/dom/File.h"
#include "mozilla/dom/FormDataBinding.h"
#include "nsTArray.h"
#include "nsWrapperCache.h"

namespace mozilla {
namespace dom {

class HTMLFormElement;
class GlobalObject;

class FormData final : public nsISupports,
                       public HTMLFormSubmission,
                       public nsWrapperCache
  ~FormData() {}

  struct FormDataTuple
    nsString name;
    bool wasNullBlob;
    OwningBlobOrDirectoryOrUSVString value;

  // Returns the FormDataTuple to modify. This may be null, in which case
  // no element with aName was found.
  RemoveAllOthersAndGetFirstFormDataTuple(const nsAString& aName);

  void SetNameValuePair(FormDataTuple* aData,
                        const nsAString& aName,
                        const nsAString& aValue,
                        bool aWasNullBlob = false);

  void SetNameFilePair(FormDataTuple* aData,
                       const nsAString& aName,
                       File* aFile);

  void SetNameDirectoryPair(FormDataTuple* aData,
                            const nsAString& aName,
                            Directory* aDirectory);

  explicit FormData(nsISupports* aOwner = nullptr);


  // nsWrapperCache
  virtual JSObject* WrapObject(JSContext* aCx, JS::Handle<JSObject*> aGivenProto) override;

  // WebIDL
  GetParentObject() const
    return mOwner;

  static already_AddRefed<FormData>
  Constructor(const GlobalObject& aGlobal,
              const Optional<NonNull<HTMLFormElement> >& aFormElement,
              ErrorResult& aRv);

  void Append(const nsAString& aName, const nsAString& aValue,
              ErrorResult& aRv);

  void Append(const nsAString& aName, Blob& aBlob,
              const Optional<nsAString>& aFilename,
              ErrorResult& aRv);

  void Append(const nsAString& aName, Directory* aDirectory);

  void Delete(const nsAString& aName);

  void Get(const nsAString& aName, Nullable<OwningBlobOrDirectoryOrUSVString>& aOutValue);

  void GetAll(const nsAString& aName, nsTArray<OwningBlobOrDirectoryOrUSVString>& aValues);

  bool Has(const nsAString& aName);

  void Set(const nsAString& aName, Blob& aBlob,
           const Optional<nsAString>& aFilename,
           ErrorResult& aRv);
  void Set(const nsAString& aName, const nsAString& aValue,
           ErrorResult& aRv);

  uint32_t GetIterableLength() const;

  const nsAString& GetKeyAtIndex(uint32_t aIndex) const;

  const OwningBlobOrDirectoryOrUSVString& GetValueAtIndex(uint32_t aIndex) const;

  // HTMLFormSubmission
  virtual nsresult
  GetEncodedSubmission(nsIURI* aURI, nsIInputStream** aPostDataStream,
                       nsCOMPtr<nsIURI>& aOutURI) override;

  virtual nsresult AddNameValuePair(const nsAString& aName,
                                    const nsAString& aValue) override
    FormDataTuple* data = mFormData.AppendElement();
    SetNameValuePair(data, aName, aValue);
    return NS_OK;

  virtual nsresult AddNameBlobOrNullPair(const nsAString& aName,
                                         Blob* aBlob) override;

  virtual nsresult AddNameDirectoryPair(const nsAString& aName,
                                        Directory* aDirectory) override;

  typedef bool (*FormDataEntryCallback)(const nsString& aName,
                                        const OwningBlobOrDirectoryOrUSVString& aValue,
                                        void* aClosure);

  Length() const
    return mFormData.Length();

  // Stops iteration and returns false if any invocation of callback returns
  // false. Returns true otherwise.
  ForEach(FormDataEntryCallback aFunc, void* aClosure)
    for (uint32_t i = 0; i < mFormData.Length(); ++i) {
      FormDataTuple& tuple = mFormData[i];
      if (!aFunc(, tuple.value, aClosure)) {
        return false;

    return true;

  GetSendInfo(nsIInputStream** aBody, uint64_t* aContentLength,
              nsACString& aContentTypeWithCharset, nsACString& aCharset) const;

  nsCOMPtr<nsISupports> mOwner;

  nsTArray<FormDataTuple> mFormData;

} // dom namespace
} // mozilla namepsace

#endif // mozilla_dom_FormData_h