---
title: nsILocalFile
slug: nsILocalFile
tags:
  - Interfaces
  - 'Interfaces:Frozen'
  - 'Interfaces:Scriptable'
  - Todas_las_Categorías
translation_of: Mozilla/Tech/XPCOM/Reference/Interface/nsILocalFile
---
<p> </p>
<p> </p>
<p>« <a href="/en-US/docs/XPCOM_API_Reference">XPCOM API Reference</a></p>
<h3 id="Resumen" name="Resumen">Resumen</h3>
<p>La interfaz <code>nsILocalFile</code> representa un archivo o un directorio en una manera independiente de la plataforma, que es accesible en el sistema de archivos local. Por ello, incrementa <code><a href="es/NsIFile">nsIFile</a></code>.</p>
<pre class="eval"> #include "nsILocalFile.h"

 [scriptable, uuid=(aa610f20-a889-11d3-8c81-000064657374)]
 interface nsILocalFile : nsIFile { ... };
</pre>
<h3 id="M.C3.A9todos" name="M.C3.A9todos">Métodos</h3>
<dl>
 <dt>
  <code><a href="es/NsILocalFile/initWithPath">initWithPath</a></code></dt>
 <dd>
  Éste método es usado para establecer el path completo a que hace referencia nsILocalFile.</dd>
</dl>
<dl>
 <dt>
  <code><a href="es/NsILocalFile/initWithNativePath">initWithNativePath</a></code></dt>
 <dd>
  Éste método es usado para establecer el path completo a que hace referencia nsILocalFile references. [variante con los caractéres especiales locales]</dd>
</dl>
<dl>
 <dt>
  <code><a href="es/NsILocalFile/initWithFile">initWithFile</a></code></dt>
 <dd>
  Éste método se usa para inicializar un nsILocalFile desde otro nsILocalFile.</dd>
</dl>
<dl>
 <dt>
  <code><a href="es/NsILocalFile/openNSPRFileDesc">openNSPRFileDesc</a></code></dt>
 <dd>
  Éste método se usa para abrir el archivo correspondiente a este nsILocalFile.</dd>
</dl>
<dl>
 <dt>
  <code><a href="es/NsILocalFile/openANSIFileDesc">openANSIFileDesc</a></code></dt>
 <dd>
  Éste método se usa para abrir el archivo correspondiente a este nsILocalFile.</dd>
</dl>
<dl>
 <dt>
  <code><a href="es/NsILocalFile/load">load</a></code></dt>
 <dd>
  Éste método se usa para abrir la librería (enlazada dinámicamente) correspondiente a nsILocalFile.</dd>
</dl>
<dl>
 <dt>
  <code><a href="es/NsILocalFile/appendRelativePath">appendRelativePath</a></code></dt>
 <dd>
  Éste método es usado para agregar un path relativo al nsILocalFile en curso.</dd>
</dl>
<dl>
 <dt>
  <code><a href="es/NsILocalFile/appendRelativeNativePath">appendRelativeNativePath</a></code></dt>
 <dd>
  Éste método es usado para agregar un path relativo al nsILocalFile en curso. [variante con los caractéres especiales locales]</dd>
</dl>
<dl>
 <dt>
  <code><a href="es/NsILocalFile/reveal">reveal</a></code></dt>
 <dd>
  Éste método solicita que el sistema operativo revele éste nsILocalFile al usuario. No implementado en algunas plataformas.</dd>
</dl>
<dl>
 <dt>
  <code><a href="es/NsILocalFile/launch">launch</a></code></dt>
 <dd>
  Éste método solicita que el sistema operativo intente abrir éste nsILocalFile. No implementado en algunas plataformas.</dd>
</dl>
<dl>
 <dt>
  <code><a href="es/NsILocalFile/getRelativeDescriptor">getRelativeDescriptor</a></code></dt>
 <dd>
  Éste método devuelve una representación multi-plataforma del path relativo de un archivo.</dd>
</dl>
<dl>
 <dt>
  <code><a href="es/NsILocalFile/setRelativeDescriptor">setRelativeDescriptor</a></code></dt>
 <dd>
  Éste método inicializa un nsILocalFile a partir de la descripción relativa obtenida de getRelativeDescriptor.</dd>
</dl>
<h3 id="Atributos" name="Atributos">Atributos</h3>
<dl>
 <dt>
  <code><a href="es/NsILocalFile/followLinks">followLinks</a></code></dt>
 <dd>
  Éste atributo determina si el nsILocalFile resolverá o no, enlaces simbólicos.</dd>
</dl>
<dl>
 <dt>
  <code><a href="es/NsILocalFile/diskSpaceAvailable">diskSpaceAvailable</a></code></dt>
 <dd>
  Éste atributo presenta la cantidad de espacio disponible en el disco que contiene el nsILocalFile.</dd>
</dl>
<dl>
 <dt>
  <code><a href="es/NsILocalFile/persistentDescriptor">persistentDescriptor</a></code></dt>
 <dd>
  Éste atributo presenta una cadena, dependiente de la plataforma, representando el nsILocalFile.</dd>
</dl>
<h3 id="Observaciones" name="Observaciones">Observaciones</h3>
<p>Los métodos <code><a href="es/NsILocalFile/initWithNativePath">initWithNativePath</a></code> y <code><a href="es/NsILocalFile/appendRelativeNativePath">appendRelativeNativePath</a></code> toman parámetros representados por cadenas que son codificados usando el sistema de códigos local. Esto significa que no puedes usar nombres con caracteres fuera de la página de códigos de Windows, aunque Windows 2000 y posteriores no tengan problema en manejarlos. Por tanto, <b>nunca</b> uses funciones a no ser que estés absolutamente seguro de que el path que pasan es <b>siempre</b> ASCII. Ver <code><a href="es/NsIFile">nsIFile</a></code> para más información sobre los códigos de caractéres locales.</p>
<p><code><a href="es/NsILocalFile/launch">launch</a></code> y <code><a href="es/NsILocalFile/reveal">reveal</a></code> están sólo implementados en Windows, MacOSX, BeOS y OS/2 (a fecha 2007/03/14, FX3.0, Gecko 1.9). En sistemas *nix-ish tales como Linux, BSDs, Solaris o similares ninguna de estas dos funciones harán nada más que devolver inmediatamente un valor NS_ERROR_FAILURE. Ver <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=391980" title="FIXED: New Download manager automatically associates all types of files including folders with one file type">error 391980</a> para más información.<br>
 Para trabajar con esos sistemas también, querrás considerar el atajo de Firefox Download Manager. Para un poco de "inspiración" ver: <a class="external" href="http://mxr.mozilla.org/seamonkey/source/toolkit/mozapps/downloads/content/downloads.js" rel="freelink">http://mxr.mozilla.org/seamonkey/sou...t/downloads.js</a></p>
<h3 id="Historia" name="Historia">Historia</h3>
<p>Este interfaz fue congelado por Mozilla 1.0. Ver <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=129279" title="FIXED: nsIFile unicode/utf8/ascii task">error 129279</a> para más detalles.</p>
<div class="noinclude">
  </div>
<p></p>