CoroutineContext в Kotlin — это набор элементов, определяющих среду выполнения корутины. Он хранит информацию о:

• диспетчере (Dispatcher) — на каком потоке или пуле потоков будет выполняться корутина;

• Job — жизненный цикл корутины (отмена, завершение и т.д.);

• CoroutineName — имя корутины (для отладки);

• других дополнительных элементах (например, CoroutineExceptionHandler).

Каждая корутина работает в каком-то контексте, который влияет на её поведение и взаимодействие с другими корутинами.

📦 Основные компоненты CoroutineContext

1. Dispatcher

Определяет, где (на каком потоке или пуле потоков) выполняется корутина.

• Dispatchers.Main — главный UI-поток (только в Android/JS).

• Dispatchers.IO — пул потоков для сетевых и файловых операций.

• Dispatchers.Default — пул для CPU-интенсивных задач.

• Dispatchers.Unconfined — запускается в текущем потоке до первого приостановления.

launch(Dispatchers.IO) {
// Выполняется в IO-потоке
}

2. Job

Компонент, управляющий жизненным циклом корутины: позволяет отменять, отслеживать завершение, объединять иерархии.

val job = launch {
// код
}
job.cancel()

Каждая корутина автоматически получает Job и может быть вложена в другой Job.

3. CoroutineName

Позволяет назначить имя корутине, полезно для логов и отладки.

launch(CoroutineName("Загрузка данных")) {
// имя будет видно в логах и трейсах
}

4. CoroutineExceptionHandler

Обрабатывает необработанные исключения в корутине (в контексте, где нельзя использовать try-catch напрямую).

val handler = CoroutineExceptionHandler { \_, exception ->
println("Ошибка: $exception")
}
launch(handler) {
error("Крах!")
}

⚙️ Объединение контекста

CoroutineContext — это интерфейс, но на практике это иммутабельная коллекция key-value пар (Element). Все элементы можно объединять оператором +:

val context = Dispatchers.IO + CoroutineName("Network") + handler
launch(context) {
// код в IO, с именем и обработкой ошибок
}

📌 Где используется CoroutineContext

• В CoroutineScope — любой scope содержит CoroutineContext.

• В launch, async, withContext, runBlocking — можно явно задать контекст.

• В suspend-функциях через withContext(...) { ... }.

suspend fun fetchData() = withContext(Dispatchers.IO) {
// код выполняется на IO-диспетчере
}

📋 Получение и передача контекста

Можно получить текущий контекст:

val ctx = coroutineContext

Или передать его в другие корутины:

suspend fun example() {
val context = coroutineContext
withContext(context) {
// используется текущий контекст
}
}

🧠 Контекст и иерархия

Контексты корутин унаследуются от родительской корутины, если явно не указано иное. Это позволяет строить дерево Job-ов, где отмена родителя отменяет всех потомков.

✅ Пример: создание кастомного контекста

val customContext = Dispatchers.Default + CoroutineName("CustomName")
val scope = CoroutineScope(customContext)
scope.launch {
println("Текущий контекст: $coroutineContext")
}

Итого: зачем нужен CoroutineContext

• Управляет тем, где и как работает корутина.

• Позволяет контролировать потоки, жизненный цикл, отладку и ошибки.

• Объединяет всё в единый, расширяемый интерфейс.

• Используется во всех корутинных функциях: launch, async, withContext, flow, runBlocking и т.д.

CoroutineContext — это фундамент корутинной системы Kotlin, на котором строится управление их поведением, жизненным циклом и взаимодействием.