fune/xpcom/threads/DelayedRunnable.h
Andreas Pehrson 9717c27492 Bug 1695580 - In xpcom, cancel pending DelayedRunnable timers on shutdown. r=KrisWright
Because DelayedRunnables are fire-and-forget, there is no way for a targeted
EventTarget to clean them up on shutdown. Thus if a timer fires after
EventTarget shutdown it will fail to dispatch the timer event, and avoid
releasing the timer callback because it's not on the targeted thread. This
causes a leak as there is a ref-cycle between nsTimerImpl::mCallback and
DelayedRunnable::mTimer.

This patch adds nsIDelayedRunnableObserver for a target to observe which
DelayedRunnables are relying on their timer to run them. This allows the target
to schedule a shutdown task to cancel those timers and release the runnables on
the target thread.

Supported DelayedRunnable targets with this patch are TaskQueues,
eventqueue-based nsThreads and XPCOMThreadWrappers that wrap a supported
nsThread.

An assertion makes sure at runtime that future new uses of DelayedRunnable
target nsIDelayedRunnableObserver-supported event targets.

Differential Revision: https://phabricator.services.mozilla.com/D109781
2021-04-06 20:15:11 +00:00

50 lines
1.4 KiB
C++

/* -*- 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 XPCOM_THREADS_DELAYEDRUNNABLE_H_
#define XPCOM_THREADS_DELAYEDRUNNABLE_H_
#include "mozilla/TimeStamp.h"
#include "nsCOMPtr.h"
#include "nsIDelayedRunnableObserver.h"
#include "nsIRunnable.h"
#include "nsITimer.h"
#include "nsThreadUtils.h"
namespace mozilla {
class DelayedRunnable : public Runnable, public nsITimerCallback {
public:
DelayedRunnable(already_AddRefed<nsIEventTarget> aTarget,
already_AddRefed<nsIRunnable> aRunnable, uint32_t aDelay);
NS_DECL_ISUPPORTS_INHERITED
NS_DECL_NSIRUNNABLE
NS_DECL_NSITIMERCALLBACK
nsresult Init();
/**
* Cancels the underlying timer. Called when the target is going away, so the
* runnable can be released safely on the target thread.
*/
void CancelTimer();
private:
~DelayedRunnable() = default;
nsresult DoRun();
const nsCOMPtr<nsIEventTarget> mTarget;
const nsCOMPtr<nsIDelayedRunnableObserver> mObserver;
nsCOMPtr<nsIRunnable> mWrappedRunnable;
nsCOMPtr<nsITimer> mTimer;
const TimeStamp mDelayedFrom;
uint32_t mDelay;
};
} // namespace mozilla
#endif