class
Analyzer::Javascript::Astro
Overview
Astro is a filesystem-routed framework. Routes live under
src/pages/ and the URL is derived from the file path:
src/pages/index.astro → GET / src/pages/about.astro → GET /about src/pages/users/index.astro → GET /users src/pages/users/[id].astro → GET /users/{id} src/pages/[...slug].astro → GET /{slug} (catch-all) src/pages/api/users.ts → exports drive verbs
Page files (.astro, .md, .mdx, .html) are HTML pages —
always GET. API route files in src/pages/api/** (.ts, .js,
.mjs, .tsx, .jsx) export named verb handlers
(export async function GET(...), export const POST = ...).
When no explicit verb export is found we fall back to the
standard handler set (GET / POST / PUT / DELETE / PATCH) — same
heuristic the Next.js analyzer uses for catch-all handlers.
Out of scope for this first cut:
- Astro endpoints under non-conventional
src/pages/roots (the path detection is hard-coded to/src/pages/). - Per-handler request-helper scanning — Astro endpoints use
standard
Request(request.headers.get(...),request.json(),await request.formData()) but resolving reads accurately needs cross-call value tracking. Path placeholders still surface via the optimizer.
Defined in:
analyzer/analyzers/javascript/astro.crConstant Summary
-
API_EXTENSIONS =
[".ts", ".js", ".mjs", ".tsx", ".jsx"] -
EXPORT_BRACE_RES =
HTTP_METHODS.map do |m| {m, /export\s+\{\s*[^}]*\b#{m}\b[^}]*\}/} end.to_h -
EXPORT_CONST_RES =
HTTP_METHODS.map do |m| {m, /export\s+(?:const|let|var)\s+#{m}\b\s*(?::[^=]+)?=/} end.to_h -
EXPORT_FUNCTION_RES =
HTTP_METHODS.map do |m| {m, /export\s+(?:async\s+)?function\s+#{m}\b/} end.to_h -
Look for explicit verb exports first (
export const GET = .../export async function POST() {}), then fall back to the cross-method catch-all set. Compiled once per verb — interpolated regex literals would otherwise be rebuilt (full PCRE2 compile) for every method on every file. -
EXTENSIONS =
PAGE_EXTENSIONS + API_EXTENSIONS -
FALLBACK_API_METHODS =
["GET", "POST", "PUT", "DELETE", "PATCH"] -
Lowest-cost defaults for endpoints whose handler doesn't advertise its verbs explicitly. Mirrors the Next.js fallback.
-
HTTP_METHODS =
["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"] -
PAGE_EXTENSIONS =
[".astro", ".md", ".mdx", ".html"]
Class Method Summary
Instance Method Summary
- #analyze
-
#tech : String
Instance-side view of the same declaration.
Instance methods inherited from class Analyzer
analyze
analyze,
base_path : String
base_path,
base_paths : Array(String)
base_paths,
base_relative_path(path : String) : String
base_relative_path,
callees_needed? : Bool
callees_needed?,
content_matches?(content : String, markers : Regex) : Bool
content_matches?,
http_header_name(name : String) : String | Nil
http_header_name,
line_number_for_index(content : String, char_index : Int32) : Int32
line_number_for_index,
logger : NoirLogger
logger,
parallel_analyze(files : Array(String), &block : String -> Nil)
parallel_analyze,
read_file_content(path : String) : String
read_file_content,
result : Array(Endpoint)
result,
tech : String
tech,
unique_params(params : Array(Param)) : Array(Param)
unique_params,
url : String
url,
web_root_path(path : String, markers : Array(String)) : String
web_root_path
Constructor methods inherited from class Analyzer
new(options : Hash(String, YAML::Any))
new
Macros inherited from class Analyzer
analyzer_for(tech)
analyzer_for
Instance methods inherited from module FileHelper
all_files : Array(String)
all_files,
get_files_by_basename(basename : String) : Array(String)
get_files_by_basename,
get_files_by_extension(extension : String) : Array(String)
get_files_by_extension,
get_files_by_extensions(extensions : Array(String)) : Array(String)
get_files_by_extensions,
get_files_by_prefix(prefix : String) : Array(String)
get_files_by_prefix,
get_files_by_prefix_and_extension(prefix : String, extension : String) : Array(String)
get_files_by_prefix_and_extension,
get_files_by_relative_path(relative_path : String, root : String = "") : Array(String)
get_files_by_relative_path,
get_public_dir_files(base_path : String, folder : String) : Array(String)
get_public_dir_files,
get_public_files(base_path : String, anchors : Array(String) = ["shard.yml", "Gemfile"]) : Array(String)
get_public_files,
walked_path(expanded : String) : String
walked_path
Class Method Detail
Instance Method Detail
Instance-side view of the same declaration. The per-file rescues live on
this base class, which has no way to name the analyzer that is running
inside them, so a skipped file could not be attributed to a tech.
Deriving it from analyzer_for keeps the name written exactly once.