components/unexportable_keys/background_task.h

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

#ifndef COMPONENTS_UNEXPORTABLE_KEYS_BACKGROUND_TASK_H_
#define COMPONENTS_UNEXPORTABLE_KEYS_BACKGROUND_TASK_H_

#include <optional>

#include "base/component_export.h"
#include "base/functional/callback_forward.h"
#include "base/memory/scoped_refptr.h"
#include "base/time/time.h"
#include "components/unexportable_keys/background_task_priority.h"
#include "components/unexportable_keys/background_task_type.h"

namespace base {
class SequencedTaskRunner;
}

namespace unexportable_keys {

// Interface for tasks scheduled on `BackgroundLongTaskScheduler`.
class COMPONENT_EXPORT(UNEXPORTABLE_KEYS) BackgroundTask {
 public:
  // Different statuses that the task can have.
  enum class Status {
    kPending,   // The task is waiting in a queue.
    kCanceled,  // The task has been canceled by the caller.
    kPosted     // The task has been posted on the background thread.
  };

  virtual ~BackgroundTask() = default;

  // Runs the task on `background_task_runner` and invokes
  // `on_complete_callback` with `this` on the posting thread once the task
  // completes.
  virtual void Run(
      scoped_refptr<base::SequencedTaskRunner> background_task_runner,
      base::OnceCallback<void(BackgroundTask* task)> on_complete_callback) = 0;

  // Returns the current status of the task.
  virtual Status GetStatus() const = 0;

  // Returns the current priority of the task.
  virtual BackgroundTaskPriority GetPriority() const = 0;

  // Returns the task type.
  virtual BackgroundTaskType GetType() const = 0;

  // Returns the elapsed time since the task creation.
  virtual base::TimeDelta GetElapsedTimeSinceCreation() const = 0;

  // Returns the elapsed time since the task was run.
  // Returns std::nullopt if the task hasn't been run yet.
  virtual std::optional<base::TimeDelta> GetElapsedTimeSinceRun() const = 0;
};

}  // namespace unexportable_keys

#endif  // COMPONENTS_UNEXPORTABLE_KEYS_BACKGROUND_TASK_H_