fune/xpcom/base/nsIAvailableMemoryWatcherBase.idl
Toshihito Kikuchi ee072f14eb Bug 1701368 - Part6: Tab unloading precedes memory pressure events. r=gsvelto
This is the main part to address bug 1701368.

Before this patch, `nsAvailableMemoryWatcher` directly broadcasted a memory-pressure
event when we enter into a low-memory situation and `TabUnloader` unloaded a tab in
response to the memory-pressure message.  We want to decouple `TabUnloader` from
memory-pressure listeners because unloading a tab may solve a low-memory situation
alone.

With this patch, if `nsAvailableMemoryWatcher` detects a low-memory situation,
it invokes `TabUnloader` synchronously via an XPCOM interface.  If `TabUnloader`
unloads a tab, we don't do any further action.  If there is no discardable tab,
`TabUnloader` notifies back `nsAvailableMemoryWatcher` via another XPCOM interface,
so that `nsAvailableMemoryWatcher` can notify of a memory-pressure event.

Differential Revision: https://phabricator.services.mozilla.com/D117673
2021-07-06 22:30:59 +00:00

28 lines
989 B
Text

/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/* 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/. */
#include "nsISupports.idl"
/**
* nsITabUnloader: interface to represent TabUnloader
*
* nsIAvailableMemoryWatcherBase: interface to watch the system's memory
* status and invoke a registered TabUnloader when it detected a low-memory
* and high-memory situation. The logic to detect such a memory situation
* is defined per platform.
*/
[scriptable, uuid(2e530956-6054-464f-9f4c-0ae6f8de5523)]
interface nsITabUnloader : nsISupports
{
void unloadTabAsync();
};
[scriptable, uuid(b0b5701e-239d-49db-9009-37e89f86441c)]
interface nsIAvailableMemoryWatcherBase : nsISupports
{
void registerTabUnloader(in nsITabUnloader aTabUnloader);
void onUnloadAttemptCompleted(in nsresult aResult);
};