mirror of
https://github.com/denoland/deno.git
synced 2024-12-20 14:24:48 -05:00
2bbfef137c
This resurrects the `--unstable-detect-cjs` flag (which became stable), and repurposes it to attempt loading .js/.jsx/.ts/.tsx files as CJS in the following additional scenarios: 1. There is no package.json 1. There is a package.json without a "type" field Also cleans up the implementation of this in the LSP a lot by hanging `resolution_mode()` off `Document` (didn't think about doing that until now).
497 lines
15 KiB
Rust
497 lines
15 KiB
Rust
// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
|
|
//! This mod provides DenoError to unify errors across Deno.
|
|
use color_print::cformat;
|
|
use color_print::cstr;
|
|
use deno_core::error::format_frame;
|
|
use deno_core::error::JsError;
|
|
use deno_terminal::colors;
|
|
use std::fmt::Write as _;
|
|
|
|
#[derive(Debug, Clone)]
|
|
struct ErrorReference<'a> {
|
|
from: &'a JsError,
|
|
to: &'a JsError,
|
|
}
|
|
|
|
#[derive(Debug, Clone)]
|
|
struct IndexedErrorReference<'a> {
|
|
reference: ErrorReference<'a>,
|
|
index: usize,
|
|
}
|
|
|
|
#[derive(Debug)]
|
|
enum FixSuggestionKind {
|
|
Info,
|
|
Hint,
|
|
Docs,
|
|
}
|
|
|
|
#[derive(Debug)]
|
|
enum FixSuggestionMessage<'a> {
|
|
Single(&'a str),
|
|
Multiline(&'a [&'a str]),
|
|
}
|
|
|
|
#[derive(Debug)]
|
|
pub struct FixSuggestion<'a> {
|
|
kind: FixSuggestionKind,
|
|
message: FixSuggestionMessage<'a>,
|
|
}
|
|
|
|
impl<'a> FixSuggestion<'a> {
|
|
pub fn info(message: &'a str) -> Self {
|
|
Self {
|
|
kind: FixSuggestionKind::Info,
|
|
message: FixSuggestionMessage::Single(message),
|
|
}
|
|
}
|
|
|
|
pub fn info_multiline(messages: &'a [&'a str]) -> Self {
|
|
Self {
|
|
kind: FixSuggestionKind::Info,
|
|
message: FixSuggestionMessage::Multiline(messages),
|
|
}
|
|
}
|
|
|
|
pub fn hint(message: &'a str) -> Self {
|
|
Self {
|
|
kind: FixSuggestionKind::Hint,
|
|
message: FixSuggestionMessage::Single(message),
|
|
}
|
|
}
|
|
|
|
pub fn hint_multiline(messages: &'a [&'a str]) -> Self {
|
|
Self {
|
|
kind: FixSuggestionKind::Hint,
|
|
message: FixSuggestionMessage::Multiline(messages),
|
|
}
|
|
}
|
|
|
|
pub fn docs(url: &'a str) -> Self {
|
|
Self {
|
|
kind: FixSuggestionKind::Docs,
|
|
message: FixSuggestionMessage::Single(url),
|
|
}
|
|
}
|
|
}
|
|
|
|
struct AnsiColors;
|
|
|
|
impl deno_core::error::ErrorFormat for AnsiColors {
|
|
fn fmt_element(
|
|
element: deno_core::error::ErrorElement,
|
|
s: &str,
|
|
) -> std::borrow::Cow<'_, str> {
|
|
use deno_core::error::ErrorElement::*;
|
|
match element {
|
|
Anonymous | NativeFrame | FileName | EvalOrigin => {
|
|
colors::cyan(s).to_string().into()
|
|
}
|
|
LineNumber | ColumnNumber => colors::yellow(s).to_string().into(),
|
|
FunctionName | PromiseAll => colors::italic_bold(s).to_string().into(),
|
|
}
|
|
}
|
|
}
|
|
|
|
/// Take an optional source line and associated information to format it into
|
|
/// a pretty printed version of that line.
|
|
fn format_maybe_source_line(
|
|
source_line: Option<&str>,
|
|
column_number: Option<i64>,
|
|
is_error: bool,
|
|
level: usize,
|
|
) -> String {
|
|
if source_line.is_none() || column_number.is_none() {
|
|
return "".to_string();
|
|
}
|
|
|
|
let source_line = source_line.unwrap();
|
|
// sometimes source_line gets set with an empty string, which then outputs
|
|
// an empty source line when displayed, so need just short circuit here.
|
|
if source_line.is_empty() {
|
|
return "".to_string();
|
|
}
|
|
if source_line.contains("Couldn't format source line: ") {
|
|
return format!("\n{source_line}");
|
|
}
|
|
|
|
let mut s = String::new();
|
|
let column_number = column_number.unwrap();
|
|
|
|
if column_number as usize > source_line.len() {
|
|
return format!(
|
|
"\n{} Couldn't format source line: Column {} is out of bounds (source may have changed at runtime)",
|
|
colors::yellow("Warning"), column_number,
|
|
);
|
|
}
|
|
|
|
for _i in 0..(column_number - 1) {
|
|
if source_line.chars().nth(_i as usize).unwrap() == '\t' {
|
|
s.push('\t');
|
|
} else {
|
|
s.push(' ');
|
|
}
|
|
}
|
|
s.push('^');
|
|
let color_underline = if is_error {
|
|
colors::red(&s).to_string()
|
|
} else {
|
|
colors::cyan(&s).to_string()
|
|
};
|
|
|
|
let indent = format!("{:indent$}", "", indent = level);
|
|
|
|
format!("\n{indent}{source_line}\n{indent}{color_underline}")
|
|
}
|
|
|
|
fn find_recursive_cause(js_error: &JsError) -> Option<ErrorReference> {
|
|
let mut history = Vec::<&JsError>::new();
|
|
|
|
let mut current_error: &JsError = js_error;
|
|
|
|
while let Some(cause) = ¤t_error.cause {
|
|
history.push(current_error);
|
|
|
|
if let Some(seen) = history.iter().find(|&el| cause.is_same_error(el)) {
|
|
return Some(ErrorReference {
|
|
from: current_error,
|
|
to: seen,
|
|
});
|
|
} else {
|
|
current_error = cause;
|
|
}
|
|
}
|
|
|
|
None
|
|
}
|
|
|
|
fn format_aggregated_error(
|
|
aggregated_errors: &Vec<JsError>,
|
|
circular_reference_index: usize,
|
|
) -> String {
|
|
let mut s = String::new();
|
|
let mut nested_circular_reference_index = circular_reference_index;
|
|
|
|
for js_error in aggregated_errors {
|
|
let aggregated_circular = find_recursive_cause(js_error);
|
|
if aggregated_circular.is_some() {
|
|
nested_circular_reference_index += 1;
|
|
}
|
|
let error_string = format_js_error_inner(
|
|
js_error,
|
|
aggregated_circular.map(|reference| IndexedErrorReference {
|
|
reference,
|
|
index: nested_circular_reference_index,
|
|
}),
|
|
false,
|
|
vec![],
|
|
);
|
|
|
|
for line in error_string.trim_start_matches("Uncaught ").lines() {
|
|
write!(s, "\n {line}").unwrap();
|
|
}
|
|
}
|
|
|
|
s
|
|
}
|
|
|
|
fn format_js_error_inner(
|
|
js_error: &JsError,
|
|
circular: Option<IndexedErrorReference>,
|
|
include_source_code: bool,
|
|
suggestions: Vec<FixSuggestion>,
|
|
) -> String {
|
|
let mut s = String::new();
|
|
|
|
s.push_str(&js_error.exception_message);
|
|
|
|
if let Some(circular) = &circular {
|
|
if js_error.is_same_error(circular.reference.to) {
|
|
write!(s, " {}", colors::cyan(format!("<ref *{}>", circular.index)))
|
|
.unwrap();
|
|
}
|
|
}
|
|
|
|
if let Some(aggregated) = &js_error.aggregated {
|
|
let aggregated_message = format_aggregated_error(
|
|
aggregated,
|
|
circular
|
|
.as_ref()
|
|
.map(|circular| circular.index)
|
|
.unwrap_or(0),
|
|
);
|
|
s.push_str(&aggregated_message);
|
|
}
|
|
|
|
let column_number = js_error
|
|
.source_line_frame_index
|
|
.and_then(|i| js_error.frames.get(i).unwrap().column_number);
|
|
s.push_str(&format_maybe_source_line(
|
|
if include_source_code {
|
|
js_error.source_line.as_deref()
|
|
} else {
|
|
None
|
|
},
|
|
column_number,
|
|
true,
|
|
0,
|
|
));
|
|
for frame in &js_error.frames {
|
|
write!(s, "\n at {}", format_frame::<AnsiColors>(frame)).unwrap();
|
|
}
|
|
if let Some(cause) = &js_error.cause {
|
|
let is_caused_by_circular = circular
|
|
.as_ref()
|
|
.map(|circular| js_error.is_same_error(circular.reference.from))
|
|
.unwrap_or(false);
|
|
|
|
let error_string = if is_caused_by_circular {
|
|
colors::cyan(format!("[Circular *{}]", circular.unwrap().index))
|
|
.to_string()
|
|
} else {
|
|
format_js_error_inner(cause, circular, false, vec![])
|
|
};
|
|
|
|
write!(
|
|
s,
|
|
"\nCaused by: {}",
|
|
error_string.trim_start_matches("Uncaught ")
|
|
)
|
|
.unwrap();
|
|
}
|
|
if !suggestions.is_empty() {
|
|
write!(s, "\n\n").unwrap();
|
|
for (index, suggestion) in suggestions.iter().enumerate() {
|
|
write!(s, " ").unwrap();
|
|
match suggestion.kind {
|
|
FixSuggestionKind::Hint => {
|
|
write!(s, "{} ", colors::cyan("hint:")).unwrap()
|
|
}
|
|
FixSuggestionKind::Info => {
|
|
write!(s, "{} ", colors::yellow("info:")).unwrap()
|
|
}
|
|
FixSuggestionKind::Docs => {
|
|
write!(s, "{} ", colors::green("docs:")).unwrap()
|
|
}
|
|
};
|
|
match suggestion.message {
|
|
FixSuggestionMessage::Single(msg) => {
|
|
if matches!(suggestion.kind, FixSuggestionKind::Docs) {
|
|
write!(s, "{}", cformat!("<u>{}</>", msg)).unwrap();
|
|
} else {
|
|
write!(s, "{}", msg).unwrap();
|
|
}
|
|
}
|
|
FixSuggestionMessage::Multiline(messages) => {
|
|
for (idx, message) in messages.iter().enumerate() {
|
|
if idx != 0 {
|
|
writeln!(s).unwrap();
|
|
write!(s, " ").unwrap();
|
|
}
|
|
write!(s, "{}", message).unwrap();
|
|
}
|
|
}
|
|
}
|
|
|
|
if index != (suggestions.len() - 1) {
|
|
writeln!(s).unwrap();
|
|
}
|
|
}
|
|
}
|
|
|
|
s
|
|
}
|
|
|
|
fn get_suggestions_for_terminal_errors(e: &JsError) -> Vec<FixSuggestion> {
|
|
if let Some(msg) = &e.message {
|
|
if msg.contains("module is not defined")
|
|
|| msg.contains("exports is not defined")
|
|
|| msg.contains("require is not defined")
|
|
{
|
|
return vec![
|
|
FixSuggestion::info_multiline(&[
|
|
cstr!("Deno supports CommonJS modules in <u>.cjs</> files, or when the closest"),
|
|
cstr!("<u>package.json</> has a <i>\"type\": \"commonjs\"</> option.")
|
|
]),
|
|
FixSuggestion::hint_multiline(&[
|
|
"Rewrite this module to ESM,",
|
|
cstr!("or change the file extension to <u>.cjs</u>,"),
|
|
cstr!("or add <u>package.json</> next to the file with <i>\"type\": \"commonjs\"</> option,"),
|
|
cstr!("or pass <i>--unstable-detect-cjs</> flag to detect CommonJS when loading."),
|
|
]),
|
|
FixSuggestion::docs("https://docs.deno.com/go/commonjs"),
|
|
];
|
|
} else if msg.contains("__filename is not defined") {
|
|
return vec![
|
|
FixSuggestion::info(cstr!(
|
|
"<u>__filename</> global is not available in ES modules."
|
|
)),
|
|
FixSuggestion::hint(cstr!("Use <u>import.meta.filename</> instead.")),
|
|
];
|
|
} else if msg.contains("__dirname is not defined") {
|
|
return vec![
|
|
FixSuggestion::info(cstr!(
|
|
"<u>__dirname</> global is not available in ES modules."
|
|
)),
|
|
FixSuggestion::hint(cstr!("Use <u>import.meta.dirname</> instead.")),
|
|
];
|
|
} else if msg.contains("Buffer is not defined") {
|
|
return vec![
|
|
FixSuggestion::info(cstr!(
|
|
"<u>Buffer</> is not available in the global scope in Deno."
|
|
)),
|
|
FixSuggestion::hint_multiline(&[
|
|
cstr!("Import it explicitly with <u>import { Buffer } from \"node:buffer\";</>,"),
|
|
cstr!("or run again with <u>--unstable-node-globals</> flag to add this global."),
|
|
]),
|
|
];
|
|
} else if msg.contains("clearImmediate is not defined") {
|
|
return vec![
|
|
FixSuggestion::info(cstr!(
|
|
"<u>clearImmediate</> is not available in the global scope in Deno."
|
|
)),
|
|
FixSuggestion::hint_multiline(&[
|
|
cstr!("Import it explicitly with <u>import { clearImmediate } from \"node:timers\";</>,"),
|
|
cstr!("or run again with <u>--unstable-node-globals</> flag to add this global."),
|
|
]),
|
|
];
|
|
} else if msg.contains("setImmediate is not defined") {
|
|
return vec![
|
|
FixSuggestion::info(cstr!(
|
|
"<u>setImmediate</> is not available in the global scope in Deno."
|
|
)),
|
|
FixSuggestion::hint_multiline(
|
|
&[cstr!("Import it explicitly with <u>import { setImmediate } from \"node:timers\";</>,"),
|
|
cstr!("or run again with <u>--unstable-node-globals</> flag to add this global."),
|
|
]),
|
|
];
|
|
} else if msg.contains("global is not defined") {
|
|
return vec![
|
|
FixSuggestion::info(cstr!(
|
|
"<u>global</> is not available in the global scope in Deno."
|
|
)),
|
|
FixSuggestion::hint_multiline(&[
|
|
cstr!("Use <u>globalThis</> instead, or assign <u>globalThis.global = globalThis</>,"),
|
|
cstr!("or run again with <u>--unstable-node-globals</> flag to add this global."),
|
|
]),
|
|
];
|
|
} else if msg.contains("openKv is not a function") {
|
|
return vec![
|
|
FixSuggestion::info("Deno.openKv() is an unstable API."),
|
|
FixSuggestion::hint(
|
|
"Run again with `--unstable-kv` flag to enable this API.",
|
|
),
|
|
];
|
|
} else if msg.contains("cron is not a function") {
|
|
return vec![
|
|
FixSuggestion::info("Deno.cron() is an unstable API."),
|
|
FixSuggestion::hint(
|
|
"Run again with `--unstable-cron` flag to enable this API.",
|
|
),
|
|
];
|
|
} else if msg.contains("WebSocketStream is not defined") {
|
|
return vec![
|
|
FixSuggestion::info("new WebSocketStream() is an unstable API."),
|
|
FixSuggestion::hint(
|
|
"Run again with `--unstable-net` flag to enable this API.",
|
|
),
|
|
];
|
|
} else if msg.contains("Temporal is not defined") {
|
|
return vec![
|
|
FixSuggestion::info("Temporal is an unstable API."),
|
|
FixSuggestion::hint(
|
|
"Run again with `--unstable-temporal` flag to enable this API.",
|
|
),
|
|
];
|
|
} else if msg.contains("BroadcastChannel is not defined") {
|
|
return vec![
|
|
FixSuggestion::info("BroadcastChannel is an unstable API."),
|
|
FixSuggestion::hint(
|
|
"Run again with `--unstable-broadcast-channel` flag to enable this API.",
|
|
),
|
|
];
|
|
} else if msg.contains("window is not defined") {
|
|
return vec![
|
|
FixSuggestion::info("window global is not available in Deno 2."),
|
|
FixSuggestion::hint("Replace `window` with `globalThis`."),
|
|
];
|
|
} else if msg.contains("UnsafeWindowSurface is not a constructor") {
|
|
return vec![
|
|
FixSuggestion::info("Deno.UnsafeWindowSurface is an unstable API."),
|
|
FixSuggestion::hint(
|
|
"Run again with `--unstable-webgpu` flag to enable this API.",
|
|
),
|
|
];
|
|
// Try to capture errors like:
|
|
// ```
|
|
// Uncaught Error: Cannot find module '../build/Release/canvas.node'
|
|
// Require stack:
|
|
// - /.../deno/npm/registry.npmjs.org/canvas/2.11.2/lib/bindings.js
|
|
// - /.../.cache/deno/npm/registry.npmjs.org/canvas/2.11.2/lib/canvas.js
|
|
// ```
|
|
} else if msg.contains("Cannot find module")
|
|
&& msg.contains("Require stack")
|
|
&& msg.contains(".node'")
|
|
{
|
|
return vec![
|
|
FixSuggestion::info_multiline(
|
|
&[
|
|
"Trying to execute an npm package using Node-API addons,",
|
|
"these packages require local `node_modules` directory to be present."
|
|
]
|
|
),
|
|
FixSuggestion::hint_multiline(
|
|
&[
|
|
"Add `\"nodeModulesDir\": \"auto\" option to `deno.json`, and then run",
|
|
"`deno install --allow-scripts=npm:<package> --entrypoint <script>` to setup `node_modules` directory."
|
|
]
|
|
)
|
|
];
|
|
} else if msg.contains("document is not defined") {
|
|
return vec![
|
|
FixSuggestion::info(cstr!(
|
|
"<u>document</> global is not available in Deno."
|
|
)),
|
|
FixSuggestion::hint_multiline(&[
|
|
cstr!("Use a library like <u>happy-dom</>, <u>deno_dom</>, <u>linkedom</> or <u>JSDom</>"),
|
|
cstr!("and setup the <u>document</> global according to the library documentation."),
|
|
]),
|
|
];
|
|
}
|
|
}
|
|
|
|
vec![]
|
|
}
|
|
|
|
/// Format a [`JsError`] for terminal output.
|
|
pub fn format_js_error(js_error: &JsError) -> String {
|
|
let circular =
|
|
find_recursive_cause(js_error).map(|reference| IndexedErrorReference {
|
|
reference,
|
|
index: 1,
|
|
});
|
|
let suggestions = get_suggestions_for_terminal_errors(js_error);
|
|
format_js_error_inner(js_error, circular, true, suggestions)
|
|
}
|
|
|
|
#[cfg(test)]
|
|
mod tests {
|
|
use super::*;
|
|
use test_util::strip_ansi_codes;
|
|
|
|
#[test]
|
|
fn test_format_none_source_line() {
|
|
let actual = format_maybe_source_line(None, None, false, 0);
|
|
assert_eq!(actual, "");
|
|
}
|
|
|
|
#[test]
|
|
fn test_format_some_source_line() {
|
|
let actual =
|
|
format_maybe_source_line(Some("console.log('foo');"), Some(9), true, 0);
|
|
assert_eq!(
|
|
strip_ansi_codes(&actual),
|
|
"\nconsole.log(\'foo\');\n ^"
|
|
);
|
|
}
|
|
}
|