首页 > 解决方案 > 如何在 ClojureScript 中运行 eval 并访问调用 eval 的命名空间?

问题描述

我有一个函数库,我想让用户在浏览器中使用。

所以我想设置这样的情况:

我正在使用 figwheel 和 devcards 进行开发。

在主要的 core.cljsrequire中,我的库中有各种函数,所以它们都在范围内。

现在我想让用户输入一些调用该库的代码。

我知道如何使用 eval 运行该代码,但我看不到如何使我的库函数对正在评估的代码可见。

而且我对我看到的大多数文档感到困惑(例如,我怎样才能使 ClojureScript 的 eval 可以使用函数?

可能吗?如果是这样,有人有一个简单的例子吗?

干杯

菲尔

标签: namespacesevalclojurescript

解决方案


是的,可以提供对评估代码使用的环境/预编译库的访问。

首先,您必须确保库中的函数在 JavaScript 运行时中可用。换句话说,避免:advanced优化,因为这将消除编译时未调用的函数 (DCE)。自托管 ClojureScript 与:simple.

其次,您需要将分析元数据提供给将在浏览器中运行的自托管编译器(使用cljs.js/load-analysis-cache!或 的可选参数cljs.js/empty-state)。

下面是一个说明如何执行此操作的最小项目(也在https://github.com/mfikes/ambient):

项目代码

src/main/core.cljs

(ns main.core
  (:require-macros [main.core :refer [analyzer-state]])
  (:require [cljs.js]
            [library.core]))

(def state (cljs.js/empty-state))

(defn evaluate [source cb]
  (cljs.js/eval-str state source nil {:eval cljs.js/js-eval :context :expr} cb))

(defn load-library-analysis-cache! []
  (cljs.js/load-analysis-cache! state 'library.core (analyzer-state 'library.core))
  nil)

src/main.core.clj

(ns main.core
  (:require [cljs.env :as env]))

(defmacro analyzer-state [[_ ns-sym]]
  `'~(get-in @env/*compiler* [:cljs.analyzer/namespaces ns-sym]))

src/library/core.cljs

(ns library.core)

(defn my-inc [x]
  (inc x))

用法

我们有一个main.core提供evaluate函数的命名空间,这个例子将展示如何在环境/预编译library.core命名空间中调用函数。

首先,通过以下方式启动浏览器 REPL

clj -m cljs.main

在 REPL,通过评估加载我们的主命名空间

(require 'main.core)

测试我们可以评估一些代码:

(main.core/evaluate "(+ 2 3)" prn)

这应该打印

{:ns cljs.user, :value 5}

现在,由于main.corerequired library.core,我们可以调用该命名空间中的函数。在 REPL 上对此进行评估将产生11

(library.core/my-inc 10)

现在,让我们尝试使用自托管 ClojureScript 中的这个“环境”函数:

(main.core/evaluate "(library.core/my-inc 10)" prn)

您将看到以下内容

WARNING: No such namespace: library.core, could not locate library/core.cljs, library/core.cljc, or JavaScript source providing "library.core" at line 1
WARNING: Use of undeclared Var library.core/my-inc at line 1
{:ns cljs.user, :value 11}

简而言之,即使library.core.my_inc在 JavaScript 环境中可用,并且确实可以调用,产生正确的答案,你会从自托管编译器收到警告,它对这个命名空间一无所知。

这是因为编译器分析元数据不在main.core/state原子中。(自托管编译器有自己的分析状态,保存在 JavaScript 环境中的原子中,它与 JVM 编译器分析状态分开,通过 Java 环境中的 Clojure 保存。)

注意:如果我们改为library.core使用自托管编译器编译的源代码(可能通过使用main.core/evaluateto eval"(require 'library.core)"以及正确定义cljs.js/*load-fn*可以检索此源的 a ,事情会很好,并且编译器分析元数据main.core/state.但是这个示例是关于在library.core.

我们可以通过cljs.js/load-analysis-cache!加载与命名空间关联的分析缓存来解决这个问题library.core

此示例代码通过使用从基于 JVM 的编译器中获取分析缓存的宏,将这个分析缓存直接嵌入到代码中。您可以通过任何您想要的机制将此分析缓存传输到浏览器;这只是说明了一种简单地将其直接嵌入到运输代码中的方法(它只是数据)。

继续评估以下内容,看看该命名空间的分析缓存是什么样的:

(main.core/analyzer-state 'library.core)

如果你打电话

(main.core/load-library-analysis-cache!)

此分析缓存将被加载以供自托管编译器使用。

现在如果你评估

(main.core/evaluate "(library.core/my-inc 10)" prn)

你不会看到任何警告,这将被打印出来:

{:ns cljs.user, :value 11}

此外,由于自托管编译器现在具有 的分析元数据libraray.core,因此它可以正确警告 arity 错误,例如

(main.core/evaluate "(library.core/my-inc 10 12)" prn)

将导致打印:

WARNING: Wrong number of args (2) passed to library.core/my-inc at line 1

上面说明了当您没有为命名空间提供分析器缓存时会发生什么,以及如何使用cljs.js/load-analysis-cache!. 如果你知道你总是想在启动时加载缓存,你可以简单地使用一个可选参数cljs.js/empty-state在初始化时加载这个缓存:

(defn init-state [state]
  (assoc-in state [:cljs.analyzer/namespaces 'library.core]
    (analyzer-state 'library.core)))

(def state (cljs.js/empty-state init-state))

其他的项目

一些(更详细的)项目使库函数可用于浏览器中的自托管 ClojureScript:


推荐阅读