chrome/browser/net/http_auth_cache_status.h

// Copyright 2025 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef CHROME_BROWSER_NET_HTTP_AUTH_CACHE_STATUS_H_
#define CHROME_BROWSER_NET_HTTP_AUTH_CACHE_STATUS_H_

#include "base/observer_list.h"
#include "content/public/browser/web_contents_observer.h"
#include "content/public/browser/web_contents_user_data.h"
#include "third_party/blink/public/mojom/loader/resource_load_info.mojom-forward.h"

namespace content {
class RenderFrameHost;
class WebContents;
struct GlobalRequestID;
}  // namespace content

// HttpAuthCacheStatus is used to help determine the status of HTTP Auth on a
// given top-level frame.
class HttpAuthCacheStatus
    : public content::WebContentsUserData<HttpAuthCacheStatus>,
      public content::WebContentsObserver {
 public:
  // Creates an HttpAuthCacheStatus object and attaches it to `web_contents`.
  //
  // If an HttpAuthCacheStatus object already exists for the given
  // `web_contents`, this function does nothing.
  //
  // Other components should obtain a pointer to the HttpAuthCacheStatus
  // instance (if one exists) using
  // `HttpAuthCacheStatus::FromWebContents(web_contents)`.
  static void CreateForWebContents(content::WebContents* web_contents);

  HttpAuthCacheStatus(const HttpAuthCacheStatus&) = delete;
  HttpAuthCacheStatus& operator=(const HttpAuthCacheStatus&) = delete;
  ~HttpAuthCacheStatus() override;

  // content::WebContentsObserver:
  void ResourceLoadComplete(
      content::RenderFrameHost* render_frame_host,
      const content::GlobalRequestID& request_id,
      const blink::mojom::ResourceLoadInfo& resource_load_info) override;

 private:
  friend class content::WebContentsUserData<HttpAuthCacheStatus>;

  explicit HttpAuthCacheStatus(content::WebContents* web_contents);

  // Data key required for WebContentsUserData.
  WEB_CONTENTS_USER_DATA_KEY_DECL();
};
#endif  // CHROME_BROWSER_NET_HTTP_AUTH_CACHE_STATUS_H_