blob: 9516086c32a54a50c961f2eabe4e68481fdfe0d4 [file] [log] [blame]
// Copyright 2015 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#include "base/basictypes.h"
#include "content/common/content_export.h"
#include "url/gurl.h"
namespace content {
// A centralized place for making policy decisions about out-of-process iframes,
// site isolation, --site-per-process, and related features.
// This is currently static because all these modes are controlled by command-
// line flags.
// These methods can be called from any thread.
class CONTENT_EXPORT SiteIsolationPolicy {
// Returns true if the current process model might allow the use of cross-
// process iframes. This should typically used to avoid executing codepaths
// that only matter for cross-process iframes, to protect the default
// behavior.
// Note: Since cross-process frames will soon be possible by default (e.g. for
// <iframe src="http://..."> in an extension process), usage should be limited
// to temporary stop-gaps.
// Instead of calling this method, prefer to examine object state to see
// whether a particular frame happens to have a cross-process relationship
// with another, or to consult DoesSiteRequireDedicatedProcess() to see if a
// particular site merits protection.
static bool AreCrossProcessFramesPossible();
// Returns true if pages loaded from |url|'s site ought to be handled only by
// a renderer process isolated from other sites. If --site-per-process is on
// the command line, this is true for all sites.
// Eventually, this function will be made to return true for only some schemes
// (e.g. extensions) or a whitelist of sites that we should protect for this
// user.
// Although |url| is currently ignored, callers can assume for now that they
// can pass a full URL here -- they needn't canonicalize it to a site.
static bool DoesSiteRequireDedicatedProcess(const GURL& url);
// Returns true if navigation and history code should maintain per-frame
// navigation entries. This is an in-progress feature related to site
// isolation, so the return value is currently tied to --site-per-process.
// TODO(creis, avi): Make this the default, and eliminate this.
static bool UseSubframeNavigationEntries();
// Returns true if we are currently in a mode where the swapped out state
// should not be used. Currently (as an implementation strategy) swapped out
// is forbidden under --site-per-process, but our goal is to eliminate the
// mode entirely. In code that deals with the swapped out state, prefer calls
// to this function over consulting the switches directly. It will be easier
// to grep, and easier to rip out.
// TODO(nasko): When swappedout:// is eliminated entirely, this function
// should be removed and its callers cleaned up.
static bool IsSwappedOutStateForbidden();
SiteIsolationPolicy(); // Not instantiable.
} // namespace content