aboutsummaryrefslogtreecommitdiffstats
path: root/kotlinx-coroutines-core/jvm/test/IntellijIdeaDebuggerEvaluatorCompatibilityTest.kt
blob: 6bbfdd1b4bf86ec037c7f5b35c89948a1fb39ae2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
/*
 * Copyright 2016-2021 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
 */

package kotlinx.coroutines

import org.junit.Test
import kotlin.coroutines.*
import kotlin.test.*

class IntellijIdeaDebuggerEvaluatorCompatibilityTest {

    /*
     * This test verifies that our CoroutineScope is accessible to IDEA debugger.
     *
     * Consider the following scenario:
     * ```
     * runBlocking<Unit> { // this: CoroutineScope
     *     println("runBlocking")
     * }
     * ```
     * user puts breakpoint to `println` line, opens "Evaluate" window
     * and executes `launch { println("launch") }`. They (obviously) expect it to work, but
     * it won't: `{}` in `runBlocking` is `SuspendLambda` and `this` is an unused implicit receiver
     * that is removed by the compiler (because it's unused).
     *
     * But we still want to provide consistent user experience for functions with `CoroutineScope` receiver,
     * for that IDEA debugger tries to retrieve the scope via `kotlin.coroutines.coroutineContext[Job] as? CoroutineScope`
     * and with this test we're fixing this behaviour.
     *
     * Note that this behaviour is not carved in stone: IDEA fallbacks to `kotlin.coroutines.coroutineContext` for the context if necessary.
     */

    @Test
    fun testScopeIsAccessible() = runBlocking<Unit> {
        verify()

        withContext(Job()) {
            verify()
        }

        coroutineScope {
            verify()
        }

        supervisorScope {
            verify()
        }

    }

    private suspend fun verify() {
        val ctx = coroutineContext
        assertTrue { ctx.job is CoroutineScope }
    }
}