dom/url/URLSearchParams.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 mozilla_dom_URLSearchParams_h
   8 #define mozilla_dom_URLSearchParams_h
   9
  10 #include <cstdint>
  11 #include "ErrorList.h"
  12 #include "js/RootingAPI.h"
  13 #include "mozilla/AlreadyAddRefed.h"
  14 #include "mozilla/Assertions.h"
  15 #include "mozilla/RefPtr.h"
  16 #include "mozilla/UniquePtr.h"
  17 #include "nsCOMPtr.h"
  18 #include "nsCycleCollectionParticipant.h"
  19 #include "nsISupports.h"
  20 #include "nsString.h"
  21 #include "nsTArray.h"
  22 #include "nsWrapperCache.h"
  23
  24 class JSObject;
  25 class nsIGlobalObject;
  26 class nsIInputStream;
  27 struct JSContext;
  28 struct JSStructuredCloneReader;
  29 struct JSStructuredCloneWriter;
  30
  31 namespace mozilla {
  32
  33 class ErrorResult;
  34 class URLParams;
  35
  36 namespace dom {
  37
  38 class GlobalObject;
  39 class URLSearchParams;
  40 class UTF8StringSequenceSequenceOrUTF8StringUTF8StringRecordOrUTF8String;
  41 template <typename T>
  42 class Optional;
  43
  44 class URLSearchParamsObserver : public nsISupports {
  45  public:
  46   virtual ~URLSearchParamsObserver() = default;
  47
  48   virtual void URLSearchParamsUpdated(URLSearchParams* aFromThis) = 0;
  49 };
  50
  51 class URLSearchParams final : public nsISupports, public nsWrapperCache {
  52   ~URLSearchParams();
  53
  54  public:
  55   NS_DECL_CYCLE_COLLECTING_ISUPPORTS
  56   NS_DECL_CYCLE_COLLECTION_WRAPPERCACHE_CLASS(URLSearchParams)
  57
  58   explicit URLSearchParams(nsISupports* aParent,
  59                            URLSearchParamsObserver* aObserver = nullptr);
  60
  61   // WebIDL methods
  62   nsISupports* GetParentObject() const { return mParent; }
  63
  64   virtual JSObject* WrapObject(JSContext* aCx,
  65                                JS::Handle<JSObject*> aGivenProto) override;
  66
  67   static already_AddRefed<URLSearchParams> Constructor(
  68       const GlobalObject& aGlobal,
  69       const UTF8StringSequenceSequenceOrUTF8StringUTF8StringRecordOrUTF8String&
  70           aInit,
  71       ErrorResult& aRv);
  72
  73   void ParseInput(const nsACString& aInput);
  74
  75   void Serialize(nsACString& aValue) const;
  76
  77   uint32_t Size() const;
  78
  79   void Get(const nsACString& aName, nsACString& aRetval);
  80
  81   void GetAll(const nsACString& aName, nsTArray<nsCString>& aRetval);
  82
  83   void Set(const nsACString& aName, const nsACString& aValue);
  84
  85   void Append(const nsACString& aName, const nsACString& aValue);
  86
  87   bool Has(const nsACString& aName, const Optional<nsACString>& aValue);
  88
  89   void Delete(const nsACString& aName, const Optional<nsACString>& aValue);
  90
  91   uint32_t GetIterableLength() const;
  92   const nsACString& GetKeyAtIndex(uint32_t aIndex) const;
  93   const nsACString& GetValueAtIndex(uint32_t aIndex) const;
  94
  95   void Sort(ErrorResult& aRv);
  96
  97   void Stringify(nsAString&) const;
  98
  99   nsresult GetSendInfo(nsIInputStream** aBody, uint64_t* aContentLength,
 100                        nsACString& aContentTypeWithCharset,
 101                        nsACString& aCharset) const;
 102
 103  private:
 104   void AppendInternal(const nsACString& aName, const nsACString& aValue);
 105
 106   void DeleteAll();
 107
 108   void NotifyObserver();
 109
 110   UniquePtr<URLParams> mParams;
 111   nsCOMPtr<nsISupports> mParent;
 112   RefPtr<URLSearchParamsObserver> mObserver;
 113 };
 114
 115 }  // namespace dom
 116 }  // namespace mozilla
 117
 118 #endif /* mozilla_dom_URLSearchParams_h */