Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

Async flag lost when alias with type parameters (@alias Name<T> async fun) is used

Ouverte
  • Quelque chose ne va pas ?
#3,469 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

Difficulté
3/5
Temps estimé
1-2 jours
Accessibilité débutants
68/100
Type d'issue
Bug
Clarté
Clairement spécifiée
Activité
Active
Stack technique
lua
Domaine
compilers

Piste de recherche

Reproduce with the issue's ---@alias Name<T> async fun(): T snippets and hover output. The async flag is likely dropped where generic alias types get substituted — start in script/vm/ (alias/global resolution) and script/compiler/ where function types are marked async, then check script/core/diagnostics/await-in-sync.lua for how the flag is read. Done means generic-parameterized async aliases report async on hover and trigger await-in-sync, verified via the repo's test harness under script/tests.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

How are you using the lua-language-server?

NeoVim

Which OS are you using?

Linux

What is the issue affecting?

Type Checking

Expected Behaviour

When using alias generics where the alias is an async function, it should be marked with async when I give it a generic type.

```---@alias MyAsyncFunc<T> async fun(): T

---@type MyAsyncFunc<string>
local function my_function()
	return "test"
end

my_function() -- on hover, it shows async

---@diagnostic enable: await-in-sync

local function async_context()
	my_function() -- raises `await-in-sync` warning since the outer function is not marked as async
end
Actual Behaviour

When using alias generics like this, the async flag marked on those functions gets removed:

---@alias Name<T> async fun(): T
---@alias Name2<T> async fun(a: T)
---@alias Name3<T> async fun(a: T): T

Refer to the test cases below:

---@alias AsyncFuncT async fun(): any

---@alias AsyncGenericFuncT<T> async fun(): T

---@alias AnotherAsyncGenericFuncT<T> async fun(val: T)

---@alias DifferentAsyncFormat async fun<T>(val: T): T

---@class TestClass
---@field field AsyncFuncT
---@field generic_field AsyncGenericFuncT<string>
---@field another_generic AnotherAsyncGenericFuncT<integer>
---@field different DifferentAsyncFormat

---@type TestClass
local test_fields = {
	field = function() end, --- correctly marks async
	generic_field = function() -- the function is not tagged as async
		return "hello" -- the return type is correctly tagged as string
	end,
	another_generic = function(num) -- the function is not tagged as async
		print(num) -- the num is correctly tagged as integer
	end,
	different = function(x) -- correctly tags as async
		return x
	end,
}

---@type AsyncFuncT
local function test() end

test() -- correctly tags as async

---@type AsyncGenericFuncT<string>
local function test2()
	return "hello" -- correctly tags the return type as string
end

test2() -- does not tag as async

---@type AnotherAsyncGenericFuncT<integer>
local function test3(num)
	print(num) -- correctly tags as integer
end

test3(2) -- does not tag as async

---@type DifferentAsyncFormat
local function test4(x)
	return x
end

test4(20) -- correctly tags as async

local function non_async()
	test() -- if await-in-sync is enabled, this warns as expected
	-- since the function is not tagged async

	test2() -- gives no warning since its not tagged as async function
	test3(2) -- gives no warns since its not tagged as async function

	test4(4) -- warns as expected when await-in-sync is enabled
end

---@async
local function async_code()
	test() -- no warning as expected when await-in-sync is enabled
	test2()
	test3(2)
	test4(4) -- no warning as expected when await-in-sync is enabled
end

Normal alias with async fun():
Image

Alias with generic with async fun():
Image

Reproduction steps

Tested version: 3.19.1

Create an alias that has a generic beside the name, then hover the function or use it in a context where await-in-sync warning will appear.

Example:

---@alias MyAsyncFunc<T> async fun(): T
---@alias MyAsyncFuncNormal async fun(): any

---@type MyAsyncFunc<string>
local function my_function()
	return "test"
end

---@type MyAsyncFuncNormal
local function working()
	return "test"
end

---@diagnostic enable: await-in-sync

local function async_context()
	my_function() -- should raise `await-in-sync` warning
	working() -- warns with `await-in-sync`
end
Additional Notes

No response

Log File

No response

Langage dominant
Lua
Étoiles
4.4k
Forks
446
Merge moyen
8 j 9 h
PR mergées (30 j)
1

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de LuaLS/lua-language-server

Toutes les issues de LuaLS/lua-language-server

Issues similaires

Plus d'issues Lua

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.