summaryrefslogtreecommitdiffstats
path: root/dom/url/URL.h
blob: cf72a7be63893bb10a32d6899aa3cc9bc4335701 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
/* -*- 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_URL_h
#define mozilla_dom_URL_h

#include "mozilla/dom/URLSearchParams.h"
#include "nsCycleCollectionParticipant.h"
#include "nsIURI.h"
#include "nsString.h"
#include "nsWrapperCache.h"

class nsISupports;

namespace mozilla {

class ErrorResult;

namespace dom {

class Blob;
class MediaSource;
class GlobalObject;
template <typename T>
class Optional;

class URL final : public URLSearchParamsObserver, public nsWrapperCache {
 public:
  NS_DECL_CYCLE_COLLECTING_ISUPPORTS
  NS_DECL_CYCLE_COLLECTION_WRAPPERCACHE_CLASS(URL)

  explicit URL(nsISupports* aParent, nsCOMPtr<nsIURI> aURI)
      : mParent(aParent), mURI(std::move(aURI)) {
    MOZ_ASSERT(mURI);
  }

  // WebIDL methods
  nsISupports* GetParentObject() const { return mParent; }

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

  static already_AddRefed<URL> Constructor(const GlobalObject& aGlobal,
                                           const nsACString& aURL,
                                           const Optional<nsACString>& aBase,
                                           ErrorResult& aRv);

  static already_AddRefed<URL> Constructor(nsISupports* aParent,
                                           const nsACString& aURL,
                                           const nsACString& aBase,
                                           ErrorResult& aRv);

  static already_AddRefed<URL> Constructor(nsISupports* aParent,
                                           const nsACString& aURL,
                                           nsIURI* aBase, ErrorResult& aRv);

  static void CreateObjectURL(const GlobalObject& aGlobal, Blob& aBlob,
                              nsACString& aResult, ErrorResult& aRv);

  static void CreateObjectURL(const GlobalObject& aGlobal, MediaSource& aSource,
                              nsACString& aResult, ErrorResult& aRv);

  static void RevokeObjectURL(const GlobalObject& aGlobal,
                              const nsACString& aURL, ErrorResult& aRv);

  static bool IsValidObjectURL(const GlobalObject& aGlobal,
                               const nsACString& aURL, ErrorResult& aRv);

  static already_AddRefed<URL> Parse(const GlobalObject& aGlobal,
                                     const nsACString& aURL,
                                     const Optional<nsACString>& aBase);

  static bool CanParse(const GlobalObject& aGlobal, const nsACString& aURL,
                       const Optional<nsACString>& aBase);

  void GetHref(nsACString& aHref) const;
  void SetHref(const nsACString& aHref, ErrorResult& aRv);

  void GetOrigin(nsACString& aOrigin) const;

  void GetProtocol(nsACString& aProtocol) const;
  void SetProtocol(const nsACString& aProtocol);

  void GetUsername(nsACString& aUsername) const;
  void SetUsername(const nsACString& aUsername);

  void GetPassword(nsACString& aPassword) const;
  void SetPassword(const nsACString& aPassword);

  void GetHost(nsACString& aHost) const;
  void SetHost(const nsACString& aHost);

  void GetHostname(nsACString& aHostname) const;
  void SetHostname(const nsACString& aHostname);

  void GetPort(nsACString& aPort) const;
  void SetPort(const nsACString& aPort);

  void GetPathname(nsACString& aPathname) const;
  void SetPathname(const nsACString& aPathname);

  void GetSearch(nsACString& aSearch) const;
  void SetSearch(const nsACString& aSearch);

  URLSearchParams* SearchParams();

  void GetHash(nsACString& aHash) const;
  void SetHash(const nsACString& aHash);

  void ToJSON(nsACString& aResult) const { GetHref(aResult); }

  // URLSearchParamsObserver
  void URLSearchParamsUpdated(URLSearchParams* aSearchParams) override;

  nsIURI* URI() const;
  static already_AddRefed<URL> FromURI(GlobalObject&, nsIURI*);

 private:
  ~URL() = default;

  static already_AddRefed<nsIURI> ParseURI(const nsACString& aURL,
                                           const Optional<nsACString>& aBase);

  void UpdateURLSearchParams();

 private:
  void SetSearchInternal(const nsACString& aSearch);

  void CreateSearchParamsIfNeeded();

  nsCOMPtr<nsISupports> mParent;
  RefPtr<URLSearchParams> mSearchParams;
  nsCOMPtr<nsIURI> mURI;
};

bool IsChromeURI(nsIURI* aURI);

}  // namespace dom
}  // namespace mozilla

#endif /* mozilla_dom_URL_h */