Added File.sep

docs/doc/file.md

@@ -5,6 +5,7 @@ class-name: File
 class-properties:
   - cwd
   - home
+  - sep
   - tmp
 class-methods:
   - basename
@@ -47,6 +48,12 @@ The current working directory.
 The user home directory.
 
 
+{% include property class="File" name="sep" type="string" %}
+
+The preferred path separator for the current platform. This is usually the
+forward slash character `/`, but is a backslash `\` on Windows.
+
+
 {% include property class="File" name="tmp" type="string" %}
 
 The system directory for temporary files.

src/js_api_file.cc

@@ -432,6 +432,14 @@ void GetTmp(v8::Local<v8::Name> property,
   }
 }
 
+void GetSep(v8::Local<v8::Name> property,
+            const v8::PropertyCallbackInfo<v8::Value>& info) {
+  ASSERT(IsMainThread());
+  JsApi* api = JsApi::Get(info.GetIsolate());
+  char sep[2] = {std::filesystem::path::preferred_separator, '\0'};
+  info.GetReturnValue().Set(api->js()->MakeString(sep));
+}
+
 }  // namespace
 
 v8::Local<v8::Object> MakeFileApi(JsApi* api, const JsScope& scope) {
@@ -460,6 +468,7 @@ v8::Local<v8::Object> MakeFileApi(JsApi* api, const JsScope& scope) {
 
   scope.Set(file, StringId::cwd, GetCwd);
   scope.Set(file, StringId::home, GetHome);
+  scope.Set(file, StringId::sep, GetSep);
   scope.Set(file, StringId::tmp, GetTmp);
 
   scope.Set(file, StringId::basename, Basename);

src/js_strings.cc

@@ -331,6 +331,7 @@ JsStrings::JsStrings(v8::Isolate* isolate) {
   SET_STRING(ScrollLock);
   SET_STRING(Semicolon);
   SET_STRING(sender);
+  SET_STRING(sep);
   SET_STRING(setClipboardText);
   SET_STRING(setLineDash);
   SET_STRING(setTimeout);

src/js_strings.h

@@ -326,6 +326,7 @@ enum class StringId {
   ScrollLock,
   Semicolon,
   sender,
+  sep,
   setClipboardText,
   setLineDash,
   setTimeout,

types/file.d.ts

@@ -9,6 +9,12 @@ interface File {
      */
     readonly home: string;
 
+    /**
+     * The preferred path separator for the current platform. This is usually
+     * the forward slash character `/`, but is a backslash `\` on Windows.
+     */
+    readonly sep: string;
+
     /**
      * The system directory for temporary files.
      */